things  I  have  written  about 
elsewhere  #201 901 02 

Surface  Areas  -  Photos  and  Depictions  on  the... 


Surface  Areas  -  Photos  and 
Depictions  on  the  Mills  Field 
Website 


dev  |  collection  |  map  |  blog  |  random 

search  SFO  Museum 

Installation  view  of  "Aviation  Evolutions:  The  Jim 
Lund  1:72  Scale  Model  Airplane  Collection" 

This  is  a  photo  of  San  Francisco  Airport  Commission  Aviation  Library  and  Louis  A.  Turpen  Aviation  Museum  /  See  another 
random  image  of  this  museum 


This  image  depicts 

SFO  Terminal  Complex  (a  building)  and  International  Terminal  (a  terminal)  and 
International  Terminal  Main  Hall  (a  common  area)  and  San  Francisco  Airport 
Commission  Aviation  Library  and  Louis  A.  Turpen  Aviation  Museum  (a  museum) 
and  Aviation  Evolutions:  The  Jim  Lund  1 :72  Scale  Model  Airplane  Collection 

(an  exhibition) 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : //mills field . sf omuseum. or g /blog/ 20 19/0 1/02 / 
surface/  ,  in  January  2019. 


Starting  today  there  are 

pictures  https://millsfield.sfomuseum.org/images/  on  the 
Mills  Field  website! 


Not  all  the  images  but  approximately  1 ,500  photographs  of  past 
exhibitions  on 

display  https : //mil Is field . sfomuseum.org/ images/ sf omuseu 
m/  in  the  terminals  and  another  1 ,500  photos  of  airports  and 
aircraft  related  to  the  SFO  Museum  collection,  taken  by  Flickr 
users  https : / /mills field . sfomuseum.org/ images/ flickr/ 
(and  published  under  a  Creative  Commons  license). 


If  this  news  is  exciting  enough  that  you  just  want  to  dive 

in  https://millsfield.sfomuseum.org/images/  and  Start 

looking 

around  https : //millsf ield . sfomuseum.org/ images/ random/ 
right  away  here  are  the  links  you'll  want  to  know  about: 

https  ://millsfield  .sf omuseum  .org/images/ 


If  you  just  want  to  see  photographs  that  SFO  Museum  has  taken: 


https  ://millsfield  .sfomuseum  .or  g/images/ sfomuseum/ 

Or  just  photos  by  Flickr  users: 

https://millsfield.sfomuseum.org/images/flickr/ 

There  is  also  a  handy  "random  image"  link 

https://millsfield.sfomuseum.org/images/random/ 

As  I  write  this  there  are  another  30  years  worth  of  exhibition  photos 
to  process  and  another  100,000  Flickr  photos  to  review  so  this  is  just 
the  beginning  but  we're  excited  to  finally  share  the  work  we've 
already  done  so  far. 


Images  related  to  things  in  the  SFO  Museum 
collection 


“SFO  Museum” 

This  photo  was  taken  by  Flickr  user  dlvfrtual.  It  was  taken  on  May  17, 2018  and  was  published  under  the  Creative  Commons 
Attribution-NonCommercial-ShareAlike  license.  It  is  not  part  of  the  SFO  Museum  collection. 


If  you've  been  reading  this  blog  from  the  very  beginning  you  might 
remember  an  early  post  where  we  talked  about  tools  for  processing 


images  https : / /millsf ield. sfomuseum.org/blog/2018/ 07/18 
/ iiif /  . 


Using  IIIF  at  SFO  Museum 

This  is  a  blog  post  by  aaron.cope  that  was  published  on  July  18,  2018  . 


Thumbnail  and  color  palette  of  a  photo  of  the  When  Art  Rocked  exhibition  posters  in  the  International 
Terminal.  Photo  by  SFO  Museum. 


These  are  the  same  images  that  we  used  to  test  those  tools.  The 
reason  we've  been  "holding  on"  to  them  for  so  long  is  that  we  always 


wanted  to  release  these  photographs  with  another  feature  we're 
launching  today:  Depictions. 


Terminal  2  (201 4~  -  201 7~) 

Terminal  2  is  part  of  SFO  Terminal  Complex. 

This  terminal  supersedes  Terminal  2  (2011~  -  2014~)  and  is  also  superseded  by  Terminal  2  ( 2017- ) 


Boarding  Areas  Galleries  Exhibitions  Public  Art 


Here  are  three  random  images  of  Terminal  2 

There  are  281  images  of  this  terminal  /  or  just  jump  to  random  image 


Image  by  SFO  Museum. 


Image  by  SFO  Museum. 


Image  by  SFO  Museum. 


Depictions  are  the  things  in  the  photographs  themselves.  For 
example,  this 

photo  https : / /mills field . sfomuseum.org/ images /1 159342  8  0 

7/  of  the  Pacific  Coast  League:  The  West  Coast’s  Major 
League  1903- 

1957  https  : / /millsf ield. sfomuseum.org/exhibitions/11591 
6  0  019/  exhibition  is  also  a  picture  of  the 

gallery  https : / /millsf ield . sfomuseum.org/ galleries/ 13605 
16195/  ,  the 

terminal  https : //millsf ield . sfomuseum.org/ terminals/ 11593 
96147/  ,  the 

building  https : / /millsf ield. sfomuseum.org/buildings/11593 
96337/  and  the 

airport  https : / /millsf ield . sfomuseum.org/ airports/ 102  52  7 
513/  itself  where  the  exhibition  was  mounted. 


Installation  view  of  "Pacific  Coast  League:  The 
West  Coast’s  Major  League  1903-1957" 

See  all  the  images  /  or  more  images  of  San  Francisco  International  Airport  or  G-01  International  North  Wall  or  SFO 
Terminal  Complex  or  International  Terminal  or  Pacific  Coast  League:  The  West  Coast's  Major  League  1903-1957  /or  just 
view  a  random  image 


Image  by  SFO  Museum.  It  was  taken  on  Jul  27,  2009 


This  image  depicts 

San  Francisco  International  Airport  (an  airport)  and  G-01  International 
North  Wall  (a  gallery)  and  SFO  Terminal  Complex  (a  building)  and 
International  Terminal  (a  terminal)  and  Pacific  Coast  League:  The  West 
Coast’s  Major  League  1903-1957  (an  exhibition) 


Or  this 

photo  https : / /mills field . sfomuseum.org/ images /1 159322  7  9 
3  /  by  Flickr  user 

Kamblli  https  :  /  /WWW.  flickr  .  com/photos/kambui/3768 12  8853 

2  /  of  a  747  that  depicts 

SFO  http  s : / /mil Is field . sfomuseum.org/ airports/ 10252751 
3/  (that's  us  :-)  and  Air 

China  https : / /millsf ield . sfomuseum.org/ airlines/ 1 1592  83 
605/  and  the 

747  https  : / /millsf ield . sfomuseum.org/ aircraft/ 115928987 

3  /  itself. 


Air  China  Boeing  747-89L  B-2487 

See  all  the  images  /  or  more  images  of  San  Francisco  International  Airport  or  Air  China  or  Boeing  747  /  or  just  view  a 
random  image 


This  photo  is  titled  “Air  China  Boeing  747-89L  B-2487"  and  was  taken  by  Flickr  user  Kambul.  It  was  taken  on  Oct  6,  2017  and 
was  published  under  the  Creative  Commons  Attribution-NonCommercial-ShareAlike  license.  It  is  not  part  of  the  SFO  Museum 
collection. 


This  image  depicts 

San  Francisco  International  Airport  (an  airport)  and  Air  China  (an  airline) 
and  Boeing  747  (an  aircraft) 


Clicking  on  any  of  the  depictions  will  take  you  to  the  (stable  and 
permanent)  page  for  that  thing  on  the  Mills  Field  website  where, 


with  a  few  excecptions,  there  will  be  even  more  photos  to  look  at. 
Currently  it's  not  possible  to  search  for  compound  depictions,  say 
" all  the  747s  operated  by  Air  China",  but  that  will  happen  soon. 

Looking  a  little  more  closely  at  the  image  of  the  747  above  we  can 
see  that  it  also  depicts  an  Airbus 

A380  http  s : / /mills field . sfomuseum.org/ aircraft/ 11592  89 
435/  , 

Lufthansa  https : / /mil Is field . sfomuseum.org/ airlines/ 11592 
8  6  015/  and  even  United 

Airlines  https : //mil Is field . sfomuseum.org/ airlines/ 1 1592 
85413/  in  the  background.  Those  things  aren't  listed  as 
"depictions"  yet  because  we  are  still  working  on  the  tools  and  the 
workflow  for  adding  them. 


Airbus  A380 

This  aircraft  is  manufactured  by  Airbus 
This  aircraft  is  related  to  Airbus  (the  company) 


This  map  does  not  depict  exactly  where  Airbus  A380  is  from  but  rather  its  approximate  location.  Think  of  it  as  being 
more  'around  here"  than  say  another  place  in  the  world. 


Here  are  three  random  images  of  Airbus  A380 

There  are  17  images  of  this  aircraft  /  or  just  jump  to  random  image 


Lufthansa  A380-800  Landing  - 
Plane  Watching  at  In-N-Out 
Burger  near  LAX  (Los  Angeles 
International  Airport)  -  Tuesday 
June  21,2016 

This  photo  was  taken  by  Flickr 
user  cseeman.  It  was  taken  on 
Jun  21,  2016  and  was  published 
under  the  Creative  Commons 
Attribution-NonCommercial- 
ShareAlike  license.  It  is  not  part 
of  the  SFO  Museum  collection. 


A6-EOC  LAX  SUNSET 


This  photo  was  taken  by  Flickr 
user  airlines470.  It  was  taken  on 
Apr  15,  2015  and  was  published 
under  the  Creative  Commons 
Attribution-ShareAlike  license. 
It  is  not  part  of  the  SFO  Museum 
collection. 


VH-OQD  LAX 


This  photo  was  taken  by  Flickr 
user  alrlines470.  It  was  taken  on 
Apr  15,  2015  and  was  published 
under  the  Creative  Commons 
Attribution-ShareAlike  license. 
It  is  not  part  of  the  SFO  Museum 
collection. 


Flickr  photos  are  imported  based  on  the  airport  they  depict, 
demonstrating  the  benefit  of  having  a 

concordance  https : / /millsf ield . sf omuseum. org/blog/2 018/1 
2  / 03 /airlines /  between  our  respective  airport  identifiers.  In 
many  cases  those  photos  have  been 

tagged  https : / / code .flickr . net /2 00 8/ 12/ 15 /machine- tag- 
hierarchies/  with  enough  descriptive  information  that  we  can 
probably  automate  adding  depictions  for  airlines  and  aircraft.  For  the 
time  being  photos  with  depictions  of  airlines  or  aircraft  have  been 
manually  updated. 


This  photo  is  associated  with  Los  Angeles  International  Airport. 


This  photo  is  titled  "B-16719  LAX"  and  was  taken  by  Flickr  user  airlines470. 


Aircraft 

evprgreen  Air  Cargo 

Evergreen  Air  Cargo 
Evergreen  International 
Airlines 
EVA  Air  Cargo 


The  image  above  is  an  early  screenshot  showing  how  we  might  add 
depictions  to  photos,  in  this  case  an  airline.  Here's  another  screenshot 
showing  the  same  but  for  public  art  works. 


This  photo  is  titled  "Kendall  Buster,  Topograph  (2011).  At  SFO,  Terminal  2."  and 
was  taken  by  Flickr  user  mliu92. 


Airport 

Aircraft 

Airline 

Brand 

Terminal 


Topograph  I  and  II 

Topograph  I  and  II 
Topograph  I  and  II 
(1159162757) 


For  things  that  are  ’'native'1  to  the  airport  and  the  museum  we  can 
often  infer  multiple  depictions  from  a  single  pointer.  For  example,  if 
we  have  a  photo  of  Kendall  Buster's  Topograph  I  and 
II  https : / /millsf ield . sfomuseum.org/publicart/ 115916275 
7  /  we  know  that  it  also  depicts  the  Main 

Hall  https  :  / /millsf  ield.  sfomuseum.org/boardingareas/11591 

57327/  in  Terminal 


2  https : / /mills field. sfomuseum.org/terminals/1159157325 
/  . 


What  can  be  depicted  in  images  and  photographs?  Anything  that  is 
considered  a  "first-class  object"  in  the  SFO  Museum  collection 
(including  objects  in  the  aviation 

collection  https  :  / /www.  f  lysfo .  com/museum/ aviation-museum- 
library/collection  itself). 

That  means  all  the  architectural 

elements  https  :  / /millsf  ield .  sf  omuseum. org/blog/2 018/08/28 
/whosonf  irst/  at  SFO,  the 

exhibitions  https : / /millsf ield. sfomuseum.org/blog/2018/10/ 
1 7 /exhibitions /  and  public  art 

Works  https://millsfield.sfomuseum.org/publicart  on 
display,  other 

airports  https : / /millsf ield . sf omuseum. org/blog/2  018/10/30 
/airports/  ,  as  well  as  all  airlines  and 

Companies  https  :  / /millsf  ield .  sf  omuseum.  org/blog/2  018/12/ 
03/airlines/  and  now 

aircraft  https://millsfield.sfomuseum.org/aircraft/ 


Boeing  111  1159289979  (278) 

See  all  31  photos  random 

Photos  that  depict  Boeing  111  have  also  depicted  Los  Angeles  International  Airport  and  Korean  Air  Cargo  and  Boeing  777- 
300ER  and  EVA  Air  and  Boeing  and  San  Francisco  International  Airport  and  Air  New  Zealand  and  Air  China  and  China 
Southern  Airlines  and  China  Southern  Airlines  and  Qatar  Airways  and  Saudia  Airlines  and  SWISS  and  JAL  and  Turkish 
Airlines  and  Turkish  Airlines  and  China  Eastern  Airlines  and  China  Eastern  Airlines  and  Air  China  and  American  Airlines  and 
ANA  (All  Nippon  Airways)  and  ANA  (All  Nippon  Airways)  and  Air  New  Zealand  and  United  Airlines  and  United  Airlines  and 
Boeing  777-200  and  Southwest  Airlines  and  Boeing  737 


All  of  these  things  have  a  direct  relationship  with  objects  in  our 
collection  (where  for  the  purposes  of  this  discussion  the  "collection" 
is  inclusive  of  temporary 

exhibitions  https: / /millsf ield. sfomuseum.org/exhibitions 

/  and  public  art 

Works  https://millsfield.sfomuseum.org/publicart/  ). 


We  want  to  create  as  broad  surface  area  as  possible  for  the  things  in 
our  collection,  allowing  people  as  many  different  avenues  to  explore 
as  possible. 

The  image  above  is  another  early  screenshot  showing  all  the 
different  "first-class  objects"  related  to  the  Boeing 
777  https : / /millsf ield . sfomuseum.org/ aircraft/ 115928997 
9  /  .As  you  can  see  those  lists  can  start  to  overwhelm  a  page  so 
we're  still  thinking  about  how  best  to  display  them. 


A  World  of  Characters:  Advertising  Icons  from  the 
Warren  Dotz  Collection 

See  all  the  exhibitions  /  or  jump  to  another  random  exhibition 


This  nonaviation  exhibition  was  on  display  between  June  2014  and  January 
2015  in  the  A-02  International  South  Cases  gallery,  located  in  International 
Terminal 


Here  are  three  random  images  of  A  World  of  Characters:  Advertising 
Icons  from  the  Warren  Dotz  Collection 

There  are  60  images  of  this  exhibition  /  or  just  jump  to  random  image 


l  \ 


Installation  view  of  "A  World  of 
Characters:  Advertising  Icons 
from  the  Warren  Dotz 
Collection" 


Characters:  Advertising  Icons 
from  the  Warren  Dotz 
Collection" 


Installation  view  of  "A  World  of 
Characters:  Advertising  Icons 
from  the  Warren  Dotz 
Collection" 


Image  by  SFO  Museum.  It  was  Image  by  SFO  Museum.  It  was  Image  by  SFO  Museum.  It  was 

taken  on  Jul  22,  2014.  taken  on  Jul  25,  2014  taken  on  Jul  22, 2014. 


That's  why  we've  taken  the  time  to  start  by  identifying  all  the  things 
that  "surround"  an  object,  to  create  a  scaffolding  around  the  objects 
themselves  that  can  provide  both  context  and  the  mechanics  to  make 
those  avenues  a  reality. 


Installation  view  of  "A  World  of  Characters: 
Advertising  Icons  from  the  Warren  Dotz 
Collection" 


This  is  a  photo  of  A  World  of  Characters:  Advertising  Icons  from  the  Warren  Dotz  Collection  /  See  another  random 
image  of  this  exhibition 


Image  by  SFO  Museum.  It  was  taken  on  Jul  25,  2014. 


This  image  depicts 

San  Francisco  International  Airport  (an  airport)  and  A-02  International 
South  Cases  (a  gallery)  and  SFO  Terminal  Complex  (a  building)  and 
International  Terminal  (a  terminal)  and  A  World  of  Characters:  Advertising 
Icons  from  the  Warren  Dotz  Collection  (an  exhibition) 


In  addition  to  all  the  connections  that  exist  between  the  people  and 
places  and  things  in  our  collection  we  want  to  give  people  the 
opportunity  to  appreciate  the  depth  and  the  history  of  the  museum's 
work  at  the  airport  over  the  years. 


When  you're  standing  in  the  International  Terminal,  in  January  2019, 
looking  at  the  Caticons:  The  Cat  in 

Art  https : / /millsf ield . sfomuseum.org/ exhibitions/ 122662 
0513/  exhibition  we  want  to  make  sure  you  have  the  opportunity 

to  see  the  A  World  of  Characters:  Advertising  Icons  from  the 
Warren  Dotz 

Collection  https  :  / /millsfield.  sfomuseum.org/exhibitions/ll 
59160511/ images /  exhibit  as  well  as  the  other  33 
exhibitions  https : / /millsfield . sfomuseum.org/ galleries/ 13 6 
0516281/exhibitions/all/  that  have  been  shown  in  that  same 
gallery 

Space  https : / /millsfield . sfomuseum.org/ galleries/ 136051 
6271/  . 

Stable  identifiers  and  relationships  are  what  make  that  possible  but 

pictures  are  what  make  it 

magic  https : //millsf ield . sfomuseum.org/ galleries/ 13605 16 
281/images/  ! 


Here  are  three  random  images  of  G-02  International  North  Cases 

There  are  203  images  of  this  gallery  /  or  just  jump  to  random  image 


Installation  view  of  "A  Radiant 
Light:  The  Artistry  of  Louis  C. 
Tiffany" 


Installation  view  of  "Mingei: 
Traditional  Japanese  Arts  " 


Installation  view  of  "Joseff  of 
Hollywood:  Jeweler  to  the 
Stars" 


Image  by  SFO  Museum.  It  was 
taken  on  Aug  6,  2014. 


Image  by  SFO  Museum.  It  was 
taken  on  Aug  10,  2015. 


Image  by  SFO  Museum.  It  was 
taken  on  Feb  27,  2015. 


There  is  lots  of  work  left  to  do,  still. 

The  easiest  thing  to  start  with  will  be  processing  the  catalog  of  past 
exhibition  https : / /millsf ield. sfomuseum.org/exhibitions/ 
years/  photos,  dating  back  to  the  early-1980s.  This  will  allow  us 
to  revisit  the  earlier  work  we  did  around  image 

processing  https : / /millsf ield . sfomuseum.org/blog/ 2018/07/ 
18/iiif  /  and  to  see  whether  some  of  our  earlier  hunches  are  still 


correct. 


Assuming  we  didn't  get  something  terribly  wrong  we  should  be  able 
to  process  the  backlog  in  relatively  short-order  and  have  ample 
evidence  to  show  people  that  the  museum  really  is  everywhere  at  the 
airport. 


Here  are  three  random  images  of  John  F  Kennedy  International 
Airport 

There  are  4  images  of  this  airport  /  or  just  jump  to  random  image 


NYC  -  JFK  Airport:  TWA  Flight 
Center 

This  photo  was  taken  by  Flickr 
user  wallyg.  It  was  taken  on  Oct 
16,  2011  and  was  published 
under  the  Creative  Commons 
Attribution-NonCommercial- 
NoDerivs  license.  It  is  not  part  of 
the  SFO  Museum  collection. 


TWA  Flight  Center  Open  House 
NYC  -10/16/2011  -  53 

This  photo  was  taken  by  Flickr 
user  Kai  Brinker.  It  was  taken  on 
Oct  17,  2011  and  was  published 
under  the  Creative  Commons 

Attribution-ShareAlike  license. 

It  is  not  part  of  the  SFO  Museum 
collection. 


20121010_031 


This  photo  was  taken  by  Flickr 
user  k_dellaquila.  It  was  taken 
on  Oct  13,  2012  and  was 
published  under  the  Creative 
Commons  Attribution- 
NonCommercial  license.  It  is  not 
part  of  the  SFO  Museum 
collection. 


As  mentioned  earlier  there  are  also  100,000  Flickr  photos  of  airports 
(specifically  the  200  or  so  airports  immediately  relevant  to  our 
collection  https://millsfield.sfomuseum.org/airports/  ) 


that  we've  downloaded  https://github.com/sfomuseum/go- 
sf  omuseum-f  lickr  and  are  patiently  waiting  to  be  reviewed. 


We  are  still  trying  to  understand  what  it  means  to  show  photos  from 
Flickr  https : / /millsf ield . sfomuseum.org/ images/ f lickr/ 
on  the  Mills  Field  website.  To  be  clear:  These  photos  are  not 
formally  part  of  the  SFO  Museum  collection  and  whether  or  not  any 
of  them  ever  will  be  is  a  discussion  for  another  day. 

There  is  no  denying,  however,  that  Flickr  photographers  have  taken  a 
lot  of  great  pictures  of  airports  and  airplanes  and  even  some  of  our 
exhibitions  https : / /millsf ield . sfomuseum.org/ images /I 159 
32  92  81/  and  that  their  efforts  add  depth  and  richness  to  our  own. 

Some  of  those  100,000  photos  aren't  relevant  or  germane  to  our 
collection  (and  some  of  them  aren't  even  at  airports  because 

geotagging  photos  is 

hard  https : / /WWW. aaronland. info/weblog/2008/ 05/ 17/good/# 
thursday  )  so  the  immediate  concern  will  be  developing  tools  and 
interfaces  to  let  the  museum  work  through  the  queue. 


SFO  Safety  Training  Ex  ANA  Boeing  767-381  JA8275 


See  all  the  images  /  or  more  images  of  San  Francisco  International  Airport  /  or  more  images  of  Boeing  767  /  or  more  images  of 
Boeing  /  or  just  view  a  random  image 


This  photo  is  titled  “SFO  Safety  Training  Ex  ANA  Boeing  767-381  JA8275"  and  was  taken  by  Flickr  user  Kambui.  It  was  taken  on 
Oct  6,  2017  and  was  published  under  the  Creative  Commons  Attribution-NonCommercial-ShareAlike  license.  It  is  not  part  of  the 
SFO  Museum  collection. 


This  image  depicts 

San  Francisco  International  Airport  (an  airport)  and  Boeing  767  (an  aircraft)  and 
Boeing  (a  company) 


My  hope  is  that  we  can  use  this  work  to  inform  how  we  tackle  the 
interface(s)  for  adding  depictions  both  internally  and,  in  time,  by 
allowing  external  contributors  to  make  suggestions.  The  New  York 


Public  Library's  NYC  Space/Time  Directory  - 
Surveyor  https : / / github . com/ nypl-spacetime/ surveyor 
tools  are  also  something  we're  eager  to  try  out  with  our  work.  This  is 
all  still  a  ways  off  given  everything  we  want  to  get  done  first  but  it's 
always  good  to  have  a  plan,  or  at  least  a  goal. 


In  the  meantime  though... 

pictures!  https : / /millsf ield . sfomuseum.org/ images/ random 


PI  400054 


See  all  the  images  /  or  more  images  of  King  County  International  Airport-Boeing  Field  or  British  Airways  or  Concorde  / 
or  just  view  a  random  image 


This  photo  is  titled  “PI  400054"  and  was  taken  by  Flickr  user  theplaz.  It  was  taken  on  Jan  1 ,  201 5  and  was  published  under  the 
Creative  Commons  Attribution-NonCommercial-ShareAlike  license.  It  is  not  part  of  the  SFO  Museum  collection. 


This  image  depicts 

King  County  International  Airport-Boeing  Field  (an  airport)  and  British 
Airways  (an  airline)  and  Concorde  (an  aircraft) 


Finally,  for  the  "data  people"  in  the  audience:  As  always,  we've 
published  the  metadata  about  these  images  (media)  and  the  things 
they  depict  as  open  data.  They  are  available  from  the  sfomuseum- 
data  https  :  /  / github .  com/ sf  omuseum-data/  GitHub  repository 
but  the  links  are  also  included  below. 

https  ://github  .com/ sfomuseum-data/ sfomuseum-data-media 

https :// github  .com/ sfomuseum-data/ sfomuseum-  data-media- 

flickr 


We've  also  published  data  relating  to 

aircraft  https://millsfield.sfomuseum.org/aircraft/  in  the 
SFO  Museum  collection,  as  mentioned  at  the  end  of  our  last  blog 
post  https : / /millsf ield . sf omuseum. org/blog/2 018/12/03/ air 
lines/  . 


https ://  github  .com/ sfomuseum-data/ sfomuseum-  data-  aircraft 

These  data  are,  like  everything  else,  modeled  as  Who's  On  First 
documents  https : / /millsfield. sfomuseum.org/blog/2018/ 08/ 
2  8/whosonf  irst/  (WOF)  which  means  that  as  with  airlines  and 
other 

enterprises  https : //millsfield. sfomuseum.org/blog/2018/12/ 
o  3  /  a  i  r  l  i  ne  s  /  we  are  starting  to  twist  the  ( W OF) 
model  https : / / github . com/whosonf irst/whosonf irst- 
piacetypes/  in  ways  that  it  wasn't  necessarily  designed  for. 

But,  since  all  the  Flickr 

photos  https : / /millsfield . sfomuseum.org/ images/f lickr/ 
are  already  geotagged  as  are  all  the  SFO  Museum 
photos  https : / /millsfield . sfomuseum.org/ images/ sf omuseu 
m/  (since  we  happen  to  know  where  all  the 

galleries  https://millsfield.sfomuseum.org/galleries/  are 
located)  maybe  it's  not  such  a  stretch  after  all. 


Installation  view  of  "The  Nation’s  Game:  A  History 
of  the  National  Football  League" 

See  all  the  images  /  or  more  images  of  Boarding  Area  F  or  San  Francisco  International  Airport  or  F-02  North  Connector 
or  SFO  Terminal  Complex  or  Terminal  3  or  The  Nation’s  Game:  A  History  of  the  National  Football  League  /  or  just  view  a 
random  image 


k  " . --A 


Image  by  SFO  Museum.  It  was  taken  on  Sep  29,  2015. 


Onwards!  https  :  / /millsf  ield .  sfomuseum.org/ images/ random/ 


2019-01-02 


things  I  have  written  about 
elsewhere  #20190114 

Where  is  Gate  A1? 


Where  is  Gate  A1  ? 


negative:  San  Francisco  International  Airport  (SFO),  boarding  area  interior,  1970,  Collection  ofSFO  Museum, 

2011.032.2314 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : / /mills field . sfomuseum.org/blog/2019/ 01/14/ 
gates/  ,  in  January  2019. 


A  short  blog  post  to  let  you  know  that  we've  updated  the  location 
data  for  gates  on  the  Mills 

Field  https://miiisfieid.sfomuseum.org/  website.  Where  a 
gate  is  located  is  not  so  much  complicated  as  it  is  complex. 


When  asked,  many  people  might  tell  you  a  gate  is  the  bounded 
space,  inside  the  airport  terminal,  where  people  gather  before 
boarding  an  airplane.  Failing  that  they  might  say  it's  the  location  of 
doorway  that  connects  the  terminal  and  the  jetway.  Both  of  these 
statements  are  true  if  you're  a  passenger. 


If  you're  the  FAA,  though,  the  gate  is  actually  at  the  other  end  of  the 
jetway. 


negative:  San  Francisco  International  Airport  (SFO),  jetway,  1959,  Collection  ofSFO  Museum,  2011.032.0477 


From  their  perspective  Gate 

A1  https://millsfield.sfomuseum.org/gates/Al  is  the 
threshold  between  a  jetway  and  an  airplane.  In  fact  it's  potentially 
multiple  thresholds,  given  the  variable  length  of  airplanes  each  with 
multiple  doors. 

The  reason  for  telling  you  all  of  this  is  that  when  we  first  published 
gate 

information  https  :  / /millsf  ield.  sfomuseum.org/blog/2018/ 08 
/ 2 8/whosonf  irst/  ,  in  2018,  we  used  the  FAA's  coordinate  data.  If 
you  plotted  that  data  on  a  map  the  gate  appeared  to  be  outside  the 
terminal  on  the  airfield.  Like  this: 


Gate  A1 

Gate  A1  is  in  Boarding  Area  A  which  is  part  of  International  Terminal  /  or  see  all  the  gates 


Which  is  confusing  (not  incorrect  just  confusing)  if  you're  not  an 
airport  person.  We're  happy  to  announce  that  we've  updated  the 
location  data  for  gates  to  make  the  primary  location,  for  each  gate, 
the  doorway  between  the  terminal  and  jetway.  Like  this: 


Gate  A1 


Gate  A1  is  in  Boarding  Area  A  which  is  part  of  International  Terminal  /  or  see  all  the  gates 


We  haven't  replaced  the  FAA  data  but  rather  moved  it  in  to  an 
"alternate"  geometry  file  for  that  gate. 


The  unique  ID  for  Gate 

A1  https : / /millsf ield . sfomuseum.org/ gates/ 1 15  9 15  7  613/ 

in  2019  is  1159157613  and  its  relative  URL  is 
115/915/7  61/3/1159157  613  .geo  j  son.  One  of  the  really 
useful  things  about  organizing  data  in  to  nested  directories  derived 
from  their  unique  IDs  is  that  we  have  a  warm  and  friendly  place  to 
put  all  the  additional  data  about  that  place  outside  of  a  single  record 
that  grows  ad  infinitum. 


B  sfomuseum-data/sfomuseum-data-architecture  ©  unwatch-  i  ★star  o  VFork  o 

OCode  ©Issues  i  0.  Pull  requests  o  1*1  Projects  o  Wiki  ijJj_  Insights  <1  Settings 

Branch:  master  ▼  sfomuseum-data-architecture  /  data  /  115  /  915  /  761  /  3  /  Create  new  file  Uploadfiles  Findfile  History 

thisisaaronland  ensure  placetype_alt  Latest  commit  8clb374  an  hour  ago 

|§]  1159157613-alt-faa.geojson  updated  gates  an  hour  ago 

@  1159157613-geojson  ensure  placetype_alt  an  hour  ago 


Alternate  geometries,  for  example,  so  now  there  is  a  second  file 
living  in  the  115/915/761/3  /  folder:  1159157613.  geo  j  son 
and 1159157613-alt-faa.geojson. 


The  default  (or  common)  geometry  for  Gate  A  is  now  inside  the 
terminal  so  that's  the  coordinate  data  we  reflect  in  the  principal 
record  https : / / github . com/ sf omuseum-data/ sfomuseum-data- 
architecture/blob/master /data/ 115/9 15/7  6 1/3/1 159 157  6 13 . ge 


o  j  son  .  The  FAA  coordinates  are  still  interesting  though  so  we  keep 
them  in  a  separate  record  and  then  reference  it  in  the  primary 
record's  src  :  geom  alt  property: 


properties":  { 

" src : geom" : "f lysfo" , 
"src: geom_alt " : [ 

"  f  aa" 

] 


All  of  theory  and  practice  for  working  with  alternate  geometries  is 
described  in  the  What  is  an  alt-geometry  and  how  are  they 
defined  and  catalogued  in  Who's  On  First? 

https : / / github . com/whosonfirst/whosonfirst- 
cookbook/blob/master/how_to/creating_alt_geometries .md 
document. 


The  alternative,  or  "alt" , 

record  https : / / github . com/ sf omuseum-data/ sfomuseum-data- 
architectur e/blob/master /data/ 115/9 15/76 1/ 3/1159157613. ge 
o  j  son  itself  contains  as  little  data  as  possible.  For  example: 


{ 

"id":  1159157613, 

" type " :  " Feature " , 

"properties":  { 

" src : geom" : "f aa" , 

"wof : geomhash" : " 34bebb5dfbb5dfbl5968c63dacd4739a" , 
"wof :id":1159157613 

"bbox":  [ 

-122.387478, 

37.6142, 

-122.387478, 

37.6142 


]# 

" geometry " :  { " coordinates " : [ [-122.387478,37.6142] ] , " type " : " Multipoint " } 

> 

We  also  include  those  (FAA)  coordinates  in  the  f  aa :  latitude 
and  f  aa :  longitude  properties  of  the  principal  record  but  that's 
mostly  as  a  convenience. 

"properties":  { 

" f aa: latitude " : 37 . 6 142 , 

" faa: longitude" :-122. 387478, 

> 

Any  given  record  may  have  multiple  PREFIX :  latitude  and 
PREFIX :  longitude  properties  denoting  a  point  of  interest,  or 
"focal  point",  specific  to  that  record. 


For  an  airport  it  might  mean  one  end  of  a  jetway  rather  than  the 
other,  for  a  hospital  it  might  mean  distinguishing  between  the  general 
admission  and  emergency  entrances  and  for  a  city  it  might  mean 
distinguishing  between  its  geographic  center  and  a  suitable  place  to 
put  a  map  label. 


San  Francisco  (I850-04-1 5)  859/225/83/85922583.geojson 


this  record  supersedes:  1125285611 


Cascade  Canyon 
Open  Space 
Preserve. 
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the  map  is  currently  centered  at  37.784969,  -122.727802  #10 


In  case  you've  ever  wondered  why  so  many  maps  place  the  label  for 
the  city  of  San  Francisco  just  off  the  coast  in  the  Pacific  Ocean  it's 
because  the  Farallon 

Islands  https://en.wikipedia.org/wiki/Farallon_Islands  , 
30  miles  offshore,  are  actually  part  of  the  city  and  so  the  meaning  of 
its  geographic  "center"  is  both  correct  and...  a  little  more  nuanced 
than  maths  afford. 


Gates  that  have  been  part  of  SFO 


Gate  C45B 

This  gate  is  in  Terminal  1  (Boarding  Area  C) 


Gate  C46 

This  gate  is  in  Terminal  1  (Boarding  Area  C) 


Meanwhile,  we  will  continue  to  improve  gate  information  as  time 
and  circumstance  permit.  We  hope  to  be  able  to  publish  polygons 
representing  the  total  area  of  a  gate  inside  the  terminal,  in  addition  to 
the  door  connecting  the  terminal  to  the  jetway,  soon. 

The  data  itself  is  available  as  a  SQLite 

distribution  https  :  / /millsf  ield .  sfomuseum.org/ distribution 
s/sqiite/  or  from  the  sfomuseum- 

data  https : / / github.com/ sfomuseum-data/ sf omuseum-data- 
architecture  GitHub  organization. 


https  ://github  .com/ sfomuseum-  data/ sfomuseum-data- 

architecture 


2019-01-14 


things  I  have  written  about 
elsewhere  #20190118 

Capturing  flight  data  at  SFO  and  SFO  Museum 


Capturing  flight  data  at  SFO 
and  SFO  Museum 


annual  report:  San  Francisco  International  Airport  (SFO),  1975/1977  [1  issue:  1975/1977],  1977,  collection  ofSFO 

Museum,  2007 .048.015 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : //mills field . sf omuseum. or g /blog/ 20 19/0 1/18 / 
flights/  ,  in  January  2019. 

It's  a  bit  awkward  and  even  a  little  tacky  to  start  by  quoting  your 
past- self  but  here  is  a  thing  I 

Said  https : / /www. theatlantic . com/ technology/ archive/2015/ 
01/how-to-build-the-museum-of-the-future/384646/  ,  way 
back  in  2015,  to  frame  everything  will  follow  in  this  blog  post: 


"To  collect  a  Nest 

thermostat  https : / /collection. cooperhewitt . o 
rg/ob  jects/35460805/  absent  of  any  data,  what 
does  that  tell  you?  It  tells  you  it’s  a  beautiful  piece  of 
industrial  design  [but]  maybe  the  museum  should 
start  thinking  about  some  way  of  keeping  [the  data 
that  a  Nest 

collects  https : / /www. instructables . com/ id/Nes 
t-Thermostat-Data-Logger/  ]  alongside  the 
object,  and  maybe  [that  data]  doesn’t  need  to  be 
privileged  in  the  way  the  object  is." 


It  is  this  same  spirit  that  we're  happy  to  announce  that  we  have 
started  to  collect  and  publish  flight  data  for  all  the  arrivals  and 
departures  in  and  out  of  SFO. 


https://millsfield.sfomuseum.org/flights/ 


This  is  not  real-time  or  upcoming  flight  data.  It  is  historical  data 
compiled  by  harvesting  flight  data  throughout  the  day,  aggregating  it 
overnight  and  finally  publishing  atomic  records  (yes,  Who's  On 
First  https : / /millsf ield . sf omuseum. org/blog/2  018/ 08 /2  8 /wh 
osonf  irst/  records)  for  every  flight  that  graces  our  runways. 


All  the  airlines  that  have  flown  in  or  out  Gate  F75 

See  only  those  airlines  with  actual  planes  (so  not  code-shares)  at  this  gate  /  or  see  all  the  flights  in  and  out  of  this  gate 


This  map  does  not  depict  exactly  where  these  places  are  located  but  rather  an  approximation.  Think  of  it  as  being  more 
"around  here"  than  say  another  place  in  the  world. 


United  Airlines  (uuuu) 

This  airline  is  from  United  States 

This  airline  is  related  to  United  Airlines  (the  company) 
There  have  been  131  flights ,  since  we  started  counting. 

Air  New  Zealand  (1940) 

This  airline  is  from  New  Zealand 

This  airline  is  related  to  Air  New  Zealand  (the  company) 
There  have  been  97  flights,  since  we  started  counting. 


That's  interesting  enough  on  the  face  of  it  but  what  we  think  is  even 
more  exciting  is  that  every  record  contains  pointers  back  to  things 
already  in  the  SFO  Museum  collection. 


Things  like  the 

airlines  https://millsfield.sfomuseum.org/airlines/  that 
operated  the  flights,  the 

gates  https://millsfield.sfomuseum.org/gates/  they  flew  in 
and  out  of  and  the 

airports  https://millsfield.sfomuseum.org/airports/  they 
went  to  or  came  from.  With  only  a  few  exceptions  all  of  the  airlines 
and  gates  and  airports  that  comprise  any  given  flight,  on  any  given 
day,  all  have  a  pre-existing  relationship  with  the  objects  in  our 
collection  https  :  / /www.  f  lysfo .  com/museum/ aviation-museum- 
library/collection  . 


When  we  say  that  we  want  to  "ensure  that  every  aspect  of  a  trip  to 
SFO,  and  every  facet  of  someone’s  time  spent  in  the  airport,  leads 
back  to  the  museum’s  collection"  that  definitely  includes  the  flight 
you  were  on! 


Flights 

These  are  not  all  the  flights  in  and  out  of  SFO,  but  a  lot  of  them  /  See  just  the  arrivals  /  or  only  the  departures 


show  these  flights  at  SFO 


DL775  (ATL-SFO) 


This  Delta  Air  Lines  flight  between  Hartsfield-Jackson  Atlanta  International  Airport  and  San  Francisco  International  Airport,  on 
January  10,  2019.  It  arrived  at  gate  C43.  See  all  the  flights  for  DL775. 


We'll  fix  that  one  errant  map  tile  covering 

Indonesia  https : / /millsf ield. sfomuseum.org/ countries/85 


6322  03/  in  the  screenshot  above  shortly,  I  promise! 


Each  flight  points  to  the  specific  instance  of  a  relation  (an  airline,  a 
gate,  etc.)  at  that  moment  in  time.  This  will  become  relevant  as  soon 
as  the  first  phase  of  the  Harvey  Milk  Terminal  (or  "new  Tl")  # 
opens  later  this  year.  The  meaning  (or  at  least  the  context)  of  arriving 
at  Tl  in  December  2019  won't  be  the  same  as  it  was  in  January  of  the 
same  year. 

Eventually  we  will  add  aircraft  and  tail 

numbers  https  :  / /millsfield.  sfomuseum.org/blog/2019/ 01/02 
/surface/  as  additional  data  becomes  available.  Piggybacking  on 
our  current  data  source  has  allowed  us  to  get  ahead  of  other  work  in 
progress  (we're  at  an  airport  after  all  so  people  are  pretty  busy 
keeping  planes  in  the  sky  and  stuff :-)  and  to  imagine  what  working 
with  flight  data  means  in  a  museum  context. 

That's  why  I  started  with  this  post  with  that  old  quote  about  the  Nest. 
When  I  look  out  across  the  airfield  at  the 

terminals  https : / /millsfield. sfomuseum.org/airports/SFO/ 

I  see  a  great  big  Nest,  one  that  produces  a  lot  more  data  than  a  home 
thermostat.  SFO  Museum  doesn't  really  collect  "the  airport"  as  "an 
object"  per  se  but  our  mandate  is  to  tell  the  story  of  the  airport  so  the 
definition  of  what  the  airport  "is"  can  be  a  little...  squishy. 


Korean  Air  flights  in  and  out  of  SFO 

See  just  the  arrivals  or  only  the  departures  for  Korean  Air  /  Or  see  all  the  airports  that  Korean  Air  has  flown  to  (out  of  SFO)  or 
arrived  from 


show  all  the  airports  for  these  flights 


KE26  (SFO-ICN) 

This  Korean  Air  flight  traveled  from  San  Francisco  International  Airport  to  Incheon  International  Airport,  on  January  16,  2019.  It 
departed  from  gate  All .  See  all  the  flights  for  KE26. 

KE3485  (SFO-DTW) 

This  Korean  Air  flight  between  San  Francisco  International  Airport  and  Detroit  Metro  Airport,  on  January  16,  2019,  was  operated  by 
the  Delta  Air  Lines  flight  DL1689  (SFO-DTW).  It  departed  from  gate  C41.  See  all  the  flights  for  KE3485. 


Since  airplanes  flying  from  one  place  to  another  are  pretty  central  to 
an  airport's  purpose  it  seems  important  to  capture  the  data  around 
those  activities  specifically  as  a  way  to  help  people  understand  what 
SFO  has  done  in  the  past  and  how  those  efforts  have  changed  over 
the  years.  To  show,  as  a  museum,  how  the  evolution  of  air  travel  has 
affected  the  airport  and  the  community  that  it  is  a  part  of. 


This  is  also  early  and  experimental  work  so  in  the  short-term 
you  should  adjust  your  expectations  accordingly.  We  are  going  to 
"figure  this  out  by  doing  it"  but  that  probably  also  means  there 
will  be  some  mistakes  along  the  way. 

Importantly,  these  data  are  not  being  accessioned  in  to  the  collection 
yet.  There  is  not  a  corresponding  accession  number  for  each  flight  on 
every  day.  It  is  reasonable  to  ask:  Does  it  really  make  sense  to  collect 
every  single  flight?  Even  if  it  does,  is  this  data  better  suited  for  a 
library  or  an  archive,  rather  than  the  museum? 


report:  Mills  Field  Municipal  Airport  of  San  Francisco,  Miscellaneous  Data,  1928,  Collection  ofSFO  Museum, 

2000.018.080  a  c 


Conveniently,  SFO  Museum  is  all  three  of  these  things  so  we're  well- 
positioned  to  craft  an  answer  but  they  remain  valid  questions.  Does 
this  data  really  tell  us  anything  in  the  moment  and  if  not  have 
museums  ever  collected  these  sorts  of  data  as  a  bet  on  future- 
histories  rather  than  as  a  reflection  of  the  past? 

In  recent  years  a  number  of  initiatives  in  the  cultural  heritage  have, 

with  the  help  of  their 

audiences  https : //WWW. museumsandtheweb.com/mw2011/papers/ 
bringing_citizen_scientists_and_historians_tog  ,  compiled 
impressive  catalogs  of  past  data  ranging  from  the  Old 
Weather  https://www.oldweather.org/about.html  project  to 
transcribe  historic  ship's  logs  from  the  19th  and  early  20th  centuries 
to  the  New  York  Public  Library's  What's  on  the  Menu? 

https : / /www. nypl . or g/ voices /blogs /blog-channels /what s- 
on-the-menu  project  which  does  the  same  for  restaurants. 


Where  there  are  efforts  to  capture  contemporary  data,  like  the 
Galaxy 

Zoo  https: / /www. zooniverse.org/projects/ zookeeper/galaxy 
-zoo /about /re search  project  which  asks  participants  to  classify 
images  of  galaxies,  they  generally  aren't  undertaken  by  a  cultural 
heritage  organization.  Scientists  do  it  all  the  time;  collecting  sample 
data,  year  over  year,  for  future  use  and  research  but  do  museums? 


All  things  being  equal  are  we  even  in  a  position  to  store  and  manage 
(and  care  for)  the  volume  of  data  that  an  airport  like  SFO  produces? 
In  2019,  SFO  is  the  7th  busiest  airport  in  the  United  States  so  there 
are  a  lot  of  flights,  and  more  keep  coming  every  day. 


The  short  and  simple  answer  to  the  question  of  simply  keeping  all 
this  data,  from  a  technology  standpoint,  is  "absolutely"  but  this 
remains  uncharted  territory  for  the  cultural  heritage  sector  whether 
it's  infrastructure  or  practice  or  policy.  Collecting  (as  in  little-C 
collecting  and  not  captial-C  museum-grade  collecting)  and 
publishing  and  working  with  flight  data  as  part  of  the  Mills 
Field  https://millsfield.sfomuseum.org/  website  is  our  way 
to  poke  at  some  of  these  questions  to  help  understand  how  we  should 
answer  them. 


Search  results  for  “QF49” 


QF49  (MEL-SFO) 


This  Qantas  Airways  flight  traveled  from  Melbourne  International  Airport  to  San  Francisco  International  Airport,  on  January  09, 
2019.  It  arrived  at  gate  A8.  See  all  the  flights  for  QF49. 


QF49  (MEL-SFO) 


This  Qantas  Airways  flight  traveled  from  Melbourne  International  Airport  to  San  Francisco  International  Airport,  on  January  04, 
2019.  It  arrived  at  gate  A7.  See  all  the  flights  for  QF49. 


We  have  been  gathering  data  for  all  of  the  flights  in  and  out  of  SFO 
since  January  01, 

2019  https  : //mil Is fie Id. sfomuseum.org/ flights/2019/ 01/0 
l  .  We  also  have  data  going  back  through  December  2018  which 
we'll  process  shortly. 


The  ingest  process  hasn't  been  fully  automated  yet.  Things  are 
generally  updated  daily  there  aren't  fixed  intervals  for  new  data  yet. 


https://millsfield.sfomuseum.org/flights/ 
https  ://millsfield  .sfomuseum  .or  g/flights/  arrivals/ 
https://millsfield.sfomuseum.org/flights/departures/ 


Flights  can  be  filtered  by  year  (/YYYY)  or  month  (/YYYY/MM)  or 
day  (/YYYY/MM/DD).  For  example: 

https://millsfield.sfomuseum.org/flights/2019/ 

https://millsfield.sfomuseum.org/flights/2019/01/ 

https://millsfield.sfomuseum.org/flights/2019/01/06/ 

In  addition  to  unique  records  for  each  flight  we  also  rollup  all  the 
flights  for  a  given  flight  number.  For  example: 

https://millsfield.sfomuseum.org/flights/1360831589/ 

https://millsfield.sfomuseum.org/flights/QF50/ 

You  can't  do  any  kind  of  filtering  (dates,  arriving,  departing)  on 
/ f  lights /FLIGHT_NUMBER  URLs  yet.  You  can  also  see  flights 
for  a  specific  gate,  optionally  showing  all  the  airports  that  flights 
have  arrived  from  or  are  traveling  to: 

https://millsfield.sfomuseum.org/gates/1159157793/flights/from/ 

https://millsfield.sfomuseum.org/gates/1159157793/flights/to/ 

You  can  also  reference  gates  by  the  actual  gate  number.  In  2019  ID 
11159157793  is  the  same  as  Gate  D55  so  all  those  links 


reference  the  same  place.  If  gate  D55  ever  moves,  or  otherwise 
changes,  that  label  might  point  to  a  different  ID. 

https  ://millsfield  .sfomuseum  .or  g/gates/D55/flights/ 

It  is  possible  to  see  all  the  unique  airlines  that  have  flown  in  or  out  of 
a  gate  too: 

https  ://millsfield  .sfomuseum  .or  g/gates/D55/ airlines/ 

By  default,  we  only  show  airlines  with  actual  planes  at  the  gates  but 
you  can  also  see  all  the  other  airlines  that  had  code-sharing  flights 
(with  the  plane-operating  airline)  out  of  a  gate  by  appending  /all 
to  the  URL.  For  example: 

https  ://millsfield  .sfomuseum  .org/gates/D55/  airlines/ all/ 

And,  we  can  show  all  the  flights  for  a  given  airline.  For  example,  all 
the  Air  Canada  flights,  in  and  out  of  SFO: 

https://millsfield.sfomuseum.org/airlines/1159283597/flights/ 

Or  even: 


https://millsfield.sfomuseum.org/airlines/AIR  CANAD A/flights/ 
https://millsfield.sfomuseum.org/airlines/ACA/flights/ 
https://millsfield.sfomuseum.org/airlines/AC/flights/ 


Remember  1159283597  is  the  same  as  AIR  CANADA  is  the  same 
as  AC  A  is  the  same  as  AC.  Those  are  the  SFO  Museum  ID, 

ICAO  https  : / /millsf ield . sfomuseum.org/ concordances/ ica 
o/  callsign  and  code  and 

IATA  https  : / /millsf ield. sfomuseum.org/concordances/ iat 
a/  code  respectively,  each  of  which  refers  to  Air 
Canada  https : //millsf ield. sfomuseum.org/ airlines/ 1 1592 
83597  .1  hope  that  someone,  somewhere,  is  working  on  a  way  to  do 
for  airline  codes  and  the 

emoji  https://vimeo.com/2  09i8i367  what  the  Unicode 
Consortium  https :  /  /Unicode .  org /  worked  out  for  countries 
and  flag  emojis  https  :  //blog. emojipedia.org/emoji-flags- 
explained/ 


All  the  airports  that  flights  arriving  at  Gate  F75  have 
come  from 

See  the  airports  that  flights  leaving  from  Gate  F75  are  going  to  /  or  see  all  the  flights  in  and  out  of  this  gate 


McCarran  International  Airport  (1948-12-19) 

This  airport  in  United  States  is  also  referred  to  as  LAS  or  sometimes  KLAS 

There  have  been  29  flights ,  since  we  started  counting 


Los  Angeles  International  Airport 

This  airport  in  United  States  is  also  referred  to  as  LAX  or  sometimes  KLAX 

There  have  been  20  flights,  since  we  started  counting 


Flights  for  airlines  can  be  filtered  by  date  as  well  as  by  arrivals  and 
departures: 

https://millsfield.sfomuseum.org/airlines/1159283597/flights/depa 

rtures/ 

Those  results  can  be  filtered  again  to  list  only  those  flights  that  an 
airline  is  operating  themselves,  using  the  undocumented  ? 
principals=l  flag: 

https://millsfield.sfomuseum.org/airlines/1159283597/flights/arriv 

als/?principals=l 

Although  we  are  mentioning  the  flag  here  it  will  remain 
undocumented  for  the  time-being  because  the  combinatorial  hoo-hah 
(not  to  mention  copy  writing)  to  handle  date  filters,  arrivals  and 
departures  and  code- shares  starts  to  add  up  and,  overall,  is  still  pretty 
low  on  the  list  of  priorities. 

Oh,  and  flights  in  and  out  of  airports  (assuming  one  end  of  the 
journey  is 

SFO  https://millsfield.sfomuseum.org/airports/SFO  )  of 
course: 

https://millsfield.sfomuseum.org/airports/PEK/flights/arrivals/ 
https  ://millsfield  .sfomuseum  .org  /  airports/HND/flights/ departure 

s/ 


annual  report:  San  Francisco  International  Airport  (SFO),  2004  [1  issue:  2004],  2004,  collection  ofSFO  Museum, 

2005.038.001  a  b 


There  are  syndication 

feeds  http: / /cdevroe.com/2019/ 01/16/rss-subscribing/ 
describing  the  "shape"  of  the  flight  data  for  each  of  the  last  15  days 
in  both  the 

RSS  https : / /millsf ield . sfomuseum.org/flights/ rss . xml 
and 

Atom  https : / /millsf ield . sfomuseum.org/flights/ atom. xml 
feed  formats. 

As  always  we  are  publishing  this  data  as  a  SQLite 

database  https : / /millsfield. sfomuseum.org/distributions/ s 
qiite/  on  own  web  site  and  as  raw  Who's  On  First  -style  records 
under  the  sfomuseuin-data  https  :  / / github .  com/ sf omuseum- 
data/  GitHub  account.  Because  of  the  volume  of  flight  data  we  are 
planning  to  bundle  things  in  smaller  monthly  batches  with  the 
following  naming  convention:  sf  omuseum-data-f  lights- 
YYYY-MM.  For  example: 

https :// github  .com/ sfomuseum-data/ sfomuseum-  data-flights- 

2019-01/ 

As  mentioned  earlier  each  flight  is  published  as  Who's  On 
First  https : / /millsfield . sfomuseum. or g/blog/ 2  018/ 08 /2  8 /wh 
osonf  irst/  -style  (WOF)  record  where  every  feature's  geometry  is 
a  MultiPoint  https :  /  /tools  .  ietf  .  org/html/ rf c7  94  6#section- 
3.1.3  containing  the  centroid  for  the  departure  and  arrival  airports. 


The  label  geometry  (or 

Centroid  https : / /mills field . sfomuseum.org/blog/2019/ 01/14 
/gates/  )  is  the  gate  at 

SFO  https://millsfield.sfomuseum.org/gates  that  the  flight 
arrived  at  or  left  from.  In  the  rare  case  when  we  are  unable  to 
determine  a  gate  number  we  use 

SFO  http  s : / /mil Is field . sfomuseum.org/ airports/ SFO  's 
label  centroid. 

As  with  airlines  and 

enterprises  https : //millsf ield. sfomuseum.org/blog/2018/12/ 
03/airlines/  and  then 

photos  https : / /millsf ield . sf omuseum. org/blog/2 019/01/02/s 
urf  ace/  ,  we  are  continuing  to  overload  the  semantics  of  the  WOF 
placetype  property.  The  wof :  placetype  for  a  flight  is  said  to 
be  an  event  and  the  sf  omuseum:  placetype  is,  unsurprisingly, 
a  flight.  We  have  some  ideas  about  how  better  to  address  this 
proliferation  of  made-up  WOF  placetypes  but  we'll  save  that  for 
another  time. 


Please  remember  that  this  remains  highly  experiental  work  right 
now.  If  you  are  planning  to  try  using  it,  for  anything  at  all, 
understand  that  everything  is  in  flux  and  subject  to  change  and  may 
still  break  along  the  way. 


If  you  do  end  up  playing  with  the  data  and  build  something  you'd 
like  to  share  please  let  us 

know  https://twitter.com/sfomuseum  .  Enjoy  and  \  r<f  a*  ! 


negative:  San  Francisco  International  Airport  (SFO),  runway  construction  and  airplane  on  approach,  1958,  collection 

ofSFO  Museum,  2011.032.0468 


2019-01-18 


something  something 
something  paper  something 
something  something 

millsfield  screenshots  (2018) 


millsfield  screenshots  (2018) 


It  was  the  practice  when  I  worked  at 

Stamen  https :  /  /stamen . com  to  create  a  stand-alone  weblog  for 
every  project  we  did.  This  is  where  we  would  post  ideas  and  updates 
for  clients  throughout  the  length  of  a  contract.  We  posted  a  lot  of 
screenshots  and  over  time  these  websites  became  increasingly 
valuable  to  the  studio  itself.  They  allowed  us  to  see  the  evolution  of 


our  thinking  as  well  as  otherwise  good  ideas  that  didn't  fit  the  needs 
of  a  project. 


It's  a  habit  I  have  taken  with  me  ever  since.  When  I  was  working  at 
the  Cooper  Hewitt  https://iabs.cooperhewitt.org/  and  then 
later  at  Mapzen  https  :  //www. mapzen.com/blog/mapzen-is-now- 
a-iinux-f oundation-pro ject/  we  kept  screenshots  in  Git 
repositories.  Sometimes  we  made  those  repositories  public  as  we  did 
with  the  Who's  On  First 


project  https : / / github . com/whosonf irst/whosonf irst- 
screenshots  . 


Since  starting  to  work  at  SFO 

Museum  https://fiysfo.com/museum/  I've  been  diligently 
keeping  screenshots  of  the  Mills  Field 

project  https://millsfield.sfomuseum.org/  as  it  evolves.  At 
the  beginning  of  this  year  I  sent  last  year's  screenshots  off  to  be 
printed  and  yesterday  a  704  page  book  arrived  in  the  mail.  The  entire 


whosonf  irst-screenshots  book  for  the  three  years  between 
2015  and  2017  was  only  500  pages. 


I  wish  I  had  done  this  for  every  project,  ever.  Live  and  learn.  The 
books  themselves  are  made  with  a  little  tool  written  in  Go  called 
picturebook  https://github.com/aaronland/go-picturebook 
At  its  simplest  you  run  picturebook  by  pointing  it  at  a  folder  full 
of  images  and  a  PDF  file  pops  out  on  the  other  end.  For  example, 
this  is  what  happens  when  I  run  the  command 
. /bin/picturebook 

~/weblog/2019/ 01/30 /something/ images 


picturebook  https : / / github . com/ aaronland/ go-picturebook 
is  a  mornings-and- weekends  project  so  the  documentation  is  limited. 
It  is  only  one  of  many  possible  ways  to  do  the  same  thing.  It's  also 
the  place  where  I've  been  experimenting  with  purpose-fit  books  for 
specific  things  like  Cooper  Hewitt 

Visit  https : / /labs .cooperhewitt.org/2015/exporting-your- 
visits/  (and  shoebox  https://github.com/aaronland/go- 
cooperhewitt- shoebox  )  exports  as  well  as  the  "or  this..." 
drawings  https  :  /  / aaronland .  info/ orthis  /  ,  Something  I'll 

write  about  more  in  another  blog  post. 

2019-01-30 


wild  fires  of  joy 


(dog-eared)  history  of  the  world  in  12  maps 


a  (dog-eared)  history  of  the 
world  in  12  maps 


It's  been  a  while  since  I've  done  this,  publishing  the  passages 
underlined  in  a  book  I've  read.  One  reason  is  that  I've  been  reading 
books  I've  borrowed  from  friends  or  the  library  which  is  a  pleasure  I 
don't  feel  like  abusing  by  interjecting  myself,  literally,  on  to  the 
pages  of  shared  book.  The  second  reason  is  that  the  mechanics  which 
make  publishing  "dog-eared"  passages  easy  no  longer  seem  worth  it. 
I  wish  that  weren't  true. 


I  have  a  commute  again  and  I  make  a  point  of  using  that  time  to 
read.  A  friend  recently  asked  me  whether,  and  where,  I  was 
"broadcasting"  the  books  I  was  reading.  The  answer  is  nowhere, 
really.  It's  not  because  I  don't  want  to.  In  2013  I  was  able  to  print  a 
600-page  book  of  all  the  interesting  bits  of  books  and  articles  I'd  read 
that  year.  I  enjoy  sharing  this  stuff  and  the  thing  that  made  it  possible 
was  reading  everything  on  a  Kindle  (and  having  enough  technical 
know-how  to  extract  the  things  I'd  highlighted  from  Amazon's 
servers). 

Somewhere  between  then  and  now  I  began  to  see  reading  on  a 
networked  e-book  device  not  first  as  a  private  affair  and  only 
secondarily  as  something  I  chose  to  share  with  others,  including 
Amazon.  Perhaps  it  never  was.  It's  easy  to  believe  that  Amazon  has 
always  been  analyzing  and  leveraging  and  monetizing  the  reading 
habits  of  Kindle  users.  They  are  "good  capitalists"  that  way  and  at 
least  they  don't  make  any  pretenses  about  it. 

Still,  I  keep  coming  back  to  something  Karen  Levy 

Said  https : / / soundcloud . com/ eyebeamnyc/new-topics-in- 
social-computing-consent-and-the-network  at  beginning  of 

2015: 


...we  act  as  though  if  we  are  able  to  develop  a 
technical  means  around  a  user's  consent  then  we 
have  a  right  to  do  whatever  we  want. 


I  guess  every  new  technology  has  its  "bait  and  switch"  period.  The 
period  before  social  norms  catch  up  and  adapt  to  change,  where  the 
initial  promise  starts  to 

pale  http : / /www. aaronland . inf o/weblog/2 014 /09/1 l/brand/#d 
construct  next  to  the  abuse  and  malice  that  any  new  tool  also 
makes  possible.  That's  certainly  what  a  lot  of  the  internet  has  felt  like 
for  the  past  decade.  It  is  as  if  a  group  of  people  sat  around  the  table 
discussing  Google's  famous  maxim  to  "not  be  evil"  and  then 
wondered:  "But  wait...  how  much  money  could  we  make  if  we  were 
evil? " 

I  would  genuinely  enjoy  reading  books  on  an  electronic  device,  like 
a  Kindle.  There  is  a  lot  to  recommend  them.  I  would  gladly  pay 
Amazon  for  their  devices  and  the  books  to  read  on  them  but  I  would 
like  the  transaction  to  end  there.  I  am  not  interested  having  any 
vendor,  whether  it's  Amazon  or  a  book  publisher  or  an  author, 
looking  over  my  shoulder  while  I  am  reading,  particularly  not  when 
the  benefit  of  that  activity  seems  to  be  in  the  service  of  everyone 
except  me  as  a  reader.  This  is  not  a  critique  limited  to  Amazon.  For 
example,  it  could  (should)  be  applied  equally  to  the  recent  crop  of 


newsletters-as-a- 

Service  https : / /craigmod. com/essays /newsletters/ 

providers. 


I  look  forward  to  a  time  when  we  can  establish,  and  honour,  some 
boundaries  around  what  the  internet  makes  possible  and  for  whom. 
But  enough  of  all  that. 

A  few  years  ago  I  was  given  a  copy  of  Jerry  Brotton's  "A  History  of 
the  World  in  12 

Maps  https : / /www. theatlantic . com/ international/archive/2 
013/12/12-maps-that-changed-the-world/282666/  "  and  I  only 
recently  got  around  to  reading  it.  What  follows  are  passages  and 
quotes,  grouped  by  chapter,  that  I  highlighted  along  the  way.  In  these 
choices  it's  easy  to  see  a  reflection  of  many  of  the  interests  and 
motivations  and  concerns  in  the  on-going  work  with  the  Who's  On 
First  https://whosonfirst.org/  gazetteer  project. 


Introduction 

" It  is  a  timeless  act  of  personal  reassurance,  locating  our  selves  as 
individuals  in  relation  to  a  larger  world  that  we  suspect  is  supremely 
indifferent  to  our  existence ." 


Science 


"The  library  was  indeed  a  vast  repository  for  the  collective  memory 
of  a  classical  world  contained  within  the  books  it  catalogued.  It  was, 
to  borrow  a  phrase  from  the  history  of  science,  a  ' center  of 
calculation' ,  an  institution  with  the  resources  to  gather  and  process 
diverse  information  on  a  range  of  subjects,  where  'charts,  tables  and 
trajectories  are  commonly  at  hand  and  combinable  at  will',  and  from 
which  scholars  could  synthesize  such  information  in  search  for  more 
general  universal  truths." 


"Although  Greek  mapmaking  remained  based  on  mathematical  and 
astronimical  calculations,  Herodotus  raised  the  issue  of  how  it 
gathered,  assessed  and  incorporated  the  raw  data  gathered  by 
travellers  in  the  creation  of  a  more  comprehensive  map  of  the 
world." 


"With  this  cooperative  spirit  came  new  ways  of  seeing  maps  as 
repositories  of  knowledge,  encyclopedic  compilations  of  information, 
or  what  one  classical  historian  has  called  'a  great  inventory  of 
everything' ." 


"'The  map',  as  Christian  Jacob  has  argued,  'becomes  a  device  for 
archiving  knowledge  about  the  inhabited  world.'" 


" In  one  of  the  earliest  and  more  daring  syntheses  of  geography  and 
imperialism,  the  orbis  terrarum  came  to  define  the  world  and 
Rome  as  one  and  the  same  thing." 


" The  Geography  was  an  immense  data  bank,  compiled  by  the  first 
acknowledged  armchair  geographer,  a  'motionless  mind'  operating 
from  a  fixed  centre,  processing  diverse  geographical  data  in  to  a  vast 
archive  of  the  fixed  world." 


"We  tend  to  think  of  mapmaking  as  a  science  of  spatial 
representation,  but  Ptolemy  was  proposing  a  world  measured  not 
according  to  space,  but  by  time." 


"These  tables  enabled  mapmakers  to  plot  the  positions  of  every 
known  location  upon  a  map  with  utter  simplicity,  and  by  refusing  to 
place  explicit  boundaries  upon  his  oikoumene,  Ptolemy 
encouraged  future  mapmakers  to  plot  ever  more  locations  upon  the 
surface  of  their  world  maps." 

Empire 

"Tu  could  be  both  word  and  image,  and  often  combined  graphic 
visual  representations  with  written,  textual  descriptions  (including 
poetry )  which  were  seen  as  complementing  each  other.  As  one 
twelfth-century  scholar  put  it  'images  (tu)  are  the  warp  threads  and 
the  written  words  (shu)  are  the  weft  ...To  see  the  writing  without  the 


images  is  like  hearing  a  voice  without  seeing  the  form;  to  see  the 
image  without  the  writing  is  like  seeing  a  person  but  not  hearing  the 
words.'" 


"Both  the  Chinese  and  Korean  experiences  created  maps  that  were 
concerned  with  so  much  more  than  accurately  mapping  territory: 
they  were  also  effectively  plotting  structured  relationships." 

Discovery 

"In  the  end,  the  name  'America'  endured,  not  because  of  any 
agreement  as  to  who  discovered  it,  but  because  it  was  the  most 
politically  acceptable  term  available." 


"By  the  late  nineteenth  century  the  provenance  and  originality  of 
rare  books  and  antique  maps  had  become  a  lucrative  busines, 
particularly  in  North  America,  where  philanthropists  began  to 
endow  museums  and  cultural  institutions  in  an  attempt  to  turn  the 
study  of  American  history  into  an  internationally  respected 
discipline." 


"Naming  a  new  region  'America'  in  1507  was  a  highly  provisional 
decision,  and  dependent  on  the  ability  of  the  printing  press  to 
circulate  sensational  but  unverified  news  of  the  'discoveries'  of 
Columbus,  Vespucci  and  others." 


Toleration 


"If  this  fragmentation  was  seen  by  some  as  progress,  it  also  reduced 
mapmaking's  ability  to  transcend  worldly  conflict  and  intolerant 
attitudes  in  favour  of  a  larger  understanding  of  secular  and  scared 
space.  As  David  Harley  has  ruefully  pointed  out,  'the  Renaissance 
tradition  of  geography  as  everything  understood  in  terms  of  space,  of 
Cosmos,  got  squeezed  out'.  As  cosmography  withered  away, 
geography  'was  forced  to  buckle  down,  administer  empire,  map  and 
plan  land  uses  and  territorial  rights,  and  gather  and  analyze  useful 
data  for  purposes  of  business  and  state  administation.'" 

Money 

"On  the  new  Dutch  maps,  far-flung  territories  no  longer  simply  faded 
away  on  the  margins,  nor  were  the  world's  edges  fearful,  mythical 
places  full  of  monstrous  people  to  be  avoided  wherever  possible. 
Instead,  on  maps  like  Petrus  Plancius's  map  of  the  Moluccas  (1592), 
the  world's  borders  and  margins  were  clearly  defined  and  identified 
as  places  for  financial  exploitation,  with  its  regions  labelled 
according  to  their  commerical  interests.  Every  corner  of  the  earth 
was  being  mapped  and  assessed  for  it  commerical  possibilities." 


"Up  to  four  assistants  were  then  employed  to  execute  handdrawn 
charts  on  parchment  -  drawn  by  hand  rather  than  printed  to  try  and 
prevent  their  details  being  easily  circulated  on  the  open  market,  and 
on  parchment  because  of  its  durability  on  the  long  sea  voyage. 


Making  charts  in  this  way  allowed  for  a  quick  and  ingenious  method 
of  updating  the  original  charts.  These  would  he  revised  by  pricking 
out  new  coastlines  or  islands  with  a  needle  and  then  placed  on  top  of 
a  blank  sheet  of  parchment  and  dusted  with  soot.  Once  removed,  the 
specks  of  soot  left  on  the  new  sheet  of  parchment  through  the  needle 
pricks  could  then  be  carefully  joined  up  by  Blaeu's  assistants  to  form 
a  new  and  more  accurate  representation  of  coastlines 


"Having  failed  to  complete  his  project,  but  tailoring  so  many  copies 
of  its  first  part  for  individual  recipients,  Blaeu  inadvertently  sparked 
an  entirely  new  approach  to  atlas  consumption:  what  became  known 
as  'composite  atlases' ." 


"Rather  like  Blaeu's  own  atlases,  the  customized  examples  were 
endlessly  extensible  and  potentially  infinite:  only  the  collector's 
death  signaled  their  completion." 


"The  emergence  of  these  composite  atlases  was  a  symptom  of  the 
dilemma  experienced  by  mapmakers  and  printers  and  the  end  of  the 
seventeenth  century:  the  sheer  amount  of  geop graphical  data  they 
possessed  had  never  been  greater,  and  the  print  technology  at  their 
disposal  had  reached  such  a  level  of  speed  and  precision  that  it 
could  reproduce  such  information  in  the  finest  detail,  but  no  one  was 
clear  how  it  sould  all  be  organizaed  and  presented." 


Nation 


"It  was  not  in  modern  terms  a  national  survey  based  on 
comprehensive  topographical  details,  but  a  geodetic  survey  which 
produced  a  positional  illustration  of  places  significant  to  the 
requirements  of  state  planning 


" Under  Cassini  Ill's  guidelines,  geography  would  now  become  a 
routine  and  continuous  activity  sanctioned  by  the  state,  its 
practioners  operating  within  the  strict  guidlines  determined  by  the 
authorities .  The  age  of  the  learned  savants  uniting  the  arcane 
wisdom  of  astronomy,  astrology  and  cosmography  in  the  creation  of 
their  maps  was  coming  to  an  end.  Geographers  were  slowly  but 
surely  turning  in  to  civil  servants." 


"Of  equal  importance  to  the  work  in  the  field  was  the  paper  trail  it 
created;  from  the  land  to  the  study,  Cassini's  engineers  were 
instructed  to  write  up  their  observations  and  translate  them  into 
handdrawn  sketch  maps,  correct  them  where  necessary  and  then 
dispatch  everything  to  Paris  for  another  round  of  verification. 
Cassini  III  insisted  that  when  the  map  was  drafted,  in  was  returned 
to  the  local  diginitaries  involved  in  initially  checking  the  relevant 
topographical  data.  'The  geometrical  part  belongs  to  us,'  proclaimed 
Cassini;  'the  expression  of  the  terrain  and  spelling  of  the  names  are 
the  work  of  the  lords  and  priests;  the  engineers  present  the  map  to 
them,  profit  from  the  information  they  provide,  working  under  their 
orders,  making  in  their  presence  the  corrections  to  the  map,  which 
we  pubish  only  when  it  is  accompanied  by  certificates'  confirming 


the  veracity  of  the  information  recorded.  It  was  an  essential  element 
in  ensuring  accuracy,  but  it  had  another  consequence  too:  however 
reluctant  the  provincial  nobility  might  have  been  to  verify  the 
observations  made  by  the  unwelcome  engineers,  they  were  now 
becoming  part  of  the  fabric  of  a  national  survey.  Up  to  this  point, 
local  knowledge  had  been  ignored  in  favour  of  the  pure  geometry  of 
the  triangulated  framework  of  the  survey;  Cassini  III  now  ensured 
that  the  visualization  of  the  imagined  community  of  France  included 
the  knowledge  of  those  who  lived  and  worked  within  it." 


" Mapmaking  might  have  become  a  science,  but  Cassini  was  also 
anxious  for  the  public  to  regard  it  as  an  art." 


" The  message  was  unmistakable :  whatever  the  terrain,  every  corner 
of  the  kingdom  could  now  be  mapped  and  represented  according  to 
the  same  principles.  In  a  direct  challenge  to  the  country's  defiant 
regionalism,  the  map  established  that  nowhere  was  exceptional ." 


"The  reasons  for  this  shift  lay  in  the  transformation  of  vernacular 
languages  and  apprehensions  of  time.  In  the  West,  the  rise  of  what 
Anderson  calls  'print-capitalism'  in  the  fifteenth  century  gradually 
signalled  the  ultimate  decline  of  the  'sacred  languages'  of  imperial 
and  ecclesiastical  authority,  Greek  and  Latin,  in  favour  of  the 
vernacular  languages  spoken  by  a  vast,  new  potential  readership. 
The  subsequent  rise  of  the  novel,  the  newspaper  and  the  railway  in 
Europe  created  a  new  perception  of  'simultaneous'  time,  marked  by 


' temporal  coincidence' ,  and  measaured  by  the  introduction  of  clocks 
and  calendars.  People  began  to  imagine  the  activities  of  their  nation 
taking  place  simultaneously  across  time  and  space,  even  though  they 
were  unlikely  ever  visit  or  meet  more  than  a  tiny  fraction  of  the 
places  and  people  of  which  their  nation  is  composed." 

Geopolitics 

"In  contrast  to  the  Ordnance  Survey's  difficulty  in  providing 
standardized  maps  of  England's  complex  and  entrenched  system  of 
land  ownership  and  management,  the  English  East  India  Company 
assumed  it  would  be  much  easier  to  survey  overseas  possessions  like 
India  by  using  new  scientific  methods  and  simply  ignoring  local 
methods  of  mapping  and  owning  land,  notwithstanding  the  country's 
size." 


"In  the  words  of  Matthew  Edney,  the  survey's  most  distinguished 
historian,  the  surveyors  'did  not  map  the  "real"  India.  They  mapped 
the  India  they  perceived  and  that  they  governed',  and  as  a 
consequence  created  'a  British  India'." 


"In  attempting  to  unite  physical  geography  with  human  (or  what  he 
called  political)  geography,  Mackinder  acknowledged  the  rival 
claims  of  history  and  the  now  wildly  popular  study  of  geology. 
'Physical  geography',  he  argued,  'has  usually  been  undertaken  by 


those  already  burdened  with  geology,  political  geography  by  those 
laden  with  history.'" 


"In  pushing  geography's  case  even  further,  Mackinder  argued 
brusquely  that  'the  geologist  looks  at  the  present  that  he  may 
interpret  the  past;  the  geographer  looks  at  the  past  that  he  may 
interpret  the  present'." 


"  ...the  map  is  here  thought  of  as  a  subtle  instrument  of  expression 
applicable  to  many  orders  of  facts,  and  not  the  mere  depository  of 
names..." 


Equality 

"The  ease  with  which  political  power  used  cartographic  expertise  is 
a  recurrent  theme  of  twentieth-century  history." 


"As  one  commentator  wrote  during  the  Second  World  War,  in 
propaganda  maps  such  as  these,  'geography  as  a  science  and 
cartography  as  a  technique  become  subservient  to  the  demands  of 
effective  symbol  manipulation'." 


"...Harley  voiced  his  frustration  with  many  of  the  academic 
cartographers  of  today,  who  operate  in  a  tunnel  created  by  their  own 
technologies  with  reference  to  the  social  world.'" 


" Harley's  contention  was  not,  as  many  of  his  critics  claimed,  that  all 
maps  like,  but  that  they  contained  historical  conventions  and  social 
pressures  than  produced  what  he  called  a  'subliminal  geometry'." 


"  ...'Can  there  be  a  cartographical  ethics?'  If  maps  can  never  be 
neutral,  and  are  always  subject  to  the  power,  political  authority  and 
ideology,  then  is  it  possible  for  academic  and  professional 
cartographers  to  develop  and  sustain  an  ethical  position  in  relation 
to  their  work? " 


"The  broader  problem  that  the  controversy  inspired  was  how  to 
produce  an  ethical  cartography  once  the  profession  accepted  that 
all  maps  were  partial  and  ideological  representations  of  the  space 
they  purported  to  depict. " 


"...a  more  attractive  symbol  of  the  political  issues  at  stake  for 
development  agencies  than  any  other  cartographic  projection 
currenty  available." 


"...ever  since  Ptolemy,  individuals  and  organizations  have  used 
world  maps  for  their  own  symbolic  and  poltical  ends,  regardless  of 
the  cartographer's  claims  to  comprehensiveness  or  objectivity." 


"The  eighteenth-century  belief  in  the  ability  of  mapmaking  to  offer 
transparent,  rational  and  scientifically  objective  images  of  the  world 


exemplified  by  the  Cassini  surveys,  had  slowly  unravelled  from  the 
late  nineteenth- century  onwards,  as  the  political  dictates  of 
nationalism,  imperialism  and  a  range  of  ideologies  appropriated 
cartography  to  produce  persuasive  but  selective  maps  designed  to 
legitimate  their  particular  poltical  versions  of  the  world." 

Conclusion 

"Maps  offer  a  proposal  about  the  world,  rather  than  just  a  reflection 
of  it..." 

" The  relationship  between  a  map  and  these  assumptions  and 
preoccupations  is  always  reciprocal,  but  not  necessarily  fixed  or 
stable." 


"When  the  sheer  scale  of  implementing  such  a  project  still  requires 
some  form  of  state  of  corporate  funding,  it  is  difficult  to  imagine  it 
could  escape  the  perennial  political  or  commercial  manipulation  that 
has  so  often  tried  to  impose  a  single  image  upon  the  sheer  variety  of 
the  earth  and  its  people.  But  to  answer  no  appears  to  endorse  a 
partial  vision  that  turns  its  back  on  both  the  inevitability  of 
globalization  and  the  possibility  of  celebrating  a  common 
internation  humanity  through  geography." 


The  book  was  published  in  2012  and  the  final  chapter  (Information) 
is,  for  its  time,  an  unsuprisingly  enthusiastic  embrace  of  all  things 
Google  and  in  particular  Google  Earth.  It  is  also  notable  for  the 
absence  of  any  mention  of 

OpenStreetMap  https://www.openstreetmap.org/  (OSM)  but 
as  the  title  suggests  the  book's  focus  is  twelve  distinct  maps,  not  a 
baker's  dozen.  Also,  in  2012  you  might  have  still  been  forgiven,  but 
only  just  barely,  for  doubting  OSM.  I  don't  want  to  take  away  from 
Google  Earth's  achievements  but  a  short  seven  years  later  the  chapter 
reads  like  a  cautionary  tale  about  recording  history  too  soon. 


Finally,  it  is  hard  for  not  to  see  the  present-day  conversations  and 
concerns  around  machine-learning  in  all  of  this.  In  many  ways 
"neural  networks"  and  "training  sets"  and  "biases"  are  just  surveys 
and  map  projections  by  another  name. 
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Using  IIIF  (with  AWS)  at  SFO  Museum 


Using  IMF  (with  AWS)  at  SFO 
Museum 


Installation  view  of  "The  Modern  Consumer  -  1950s  Products  and  Styles " ,  2018.  Photo  by  SFO  Museum. 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //millsfield. sfomuseum.org/blog/2019/02/12/iiif-aws/  , 

in  February  2019. 


This  is  the  first  of  two  very  technical  blog  posts  about  how  SFO  Museum  is 
processing  images,  using  the  go-iiif  https :  / /github . com/go-iiif  software 
that  we  first  wrote  about  last 

year  https : //millsfield. sfomuseum.org/blog/2018/07/18/iiif/  and  on- 
demand  "serverless"  computers  managed  and  operated  by  Amazon  Web  Services 
(AWS). 


At  the  end  of  that  first  blog  post  about  go-iiif  we  wrote: 


An  ideal  scenario  is  one  where  a  museum  could  upload  a  set  of  full- 
sized  images  to  a  AWS  S3  bucket,  wait  for  Amazon’s  computers  to 
process  each  image  ...  and  then  find  a  new  set  of  images  to  download 
(along  with  a  reasonable  bill  for  services  rendered)  in  a  different  S3 
bucket. 


Today,  that  is  possible. 


This  is  also  where  things  start  to  get  technical  so  if  you're  not  interested  in  how  the 
proverbial  sausage  is  made  you  might  want  to  stop  here  and  simply  enjoy  the 
punchline  which  is:  More,  different  images;  faster  and  cheaper. 


A  quick  refresher:  1 1  IF  is  an  acronym  for  the  International  Image 
Interoperability  Framework  http :  //iiif .  io/  ,  a  project  driven  by  public 
institutions  and  private  companies  in  the  cultural  heritage  sector  to  produce 
common  standards  and  interfaces  (APIs)  for  accessing  and  working  with 
collections  material. 


Installtion  view  (halftoned)  of " A  Sterling  Renaissance ,  British  Silver  Design  1957-2018 " ,  2018.  Photo  by  SFO  Museum. 


go-iiif  https://github.com/go-iiif/go-iiif  is  software  written  in  the  Go 
programming  language  https :  //goiang.org  that  implements  the  IIIF 
Image  API  http://iiif.io/api/image/  and  that  SFO  Museum  has  been 
using  to  process  the  images  in  its  collection.  Today  we  are  happy  to  announce  the 
following  contributions  to  the  go-iiif  https://github.com/go-iiif/go-iiif 
project: 


•  A  simple  tool  called  Hi  f -process  and  a  declarative  syntax  for 
creating  multiple  derivative  images  in  parallel. 


This  is  a  thin  layer  on  top  of  go-iiif  to  make  generating  a  common  set  of 
derivatives  (thumbnails,  cropped  images,  and  so  on)  for  a  large  body  of  source 
images  just  a  little  bit  easier.  Everything  else  that  follows  is  the  scaffolding 
required  to  run  these  tools  on  other  people's  infrastructure. 


A  Dockerfile  to  run  the  tool  inside  of  a  container. 


If  you're  not  sure  what  "Dockerfile"  or  "container"  mean  it's  easiest  to  think  of  the 
latter  as  a  virtual  computer  and  the  former  as  the  instructions  (used  by  an 
application  called  Docker  https :  /  /docker .  com  )  to  create  it. 


•  A  second  tool  called  iiif-process-ecs  to  run  the  iiif- 
process  tool  ( inside  a  container)  as  either  an  AWS  Elastic 
Compute  https://aws.amazon.com/ecs/  (ECS)  task 


•  The  iiif-process-ecs  tool  can  also  be  run  as  an  AWS 
Lambda  https://aws.amazon.com/lambda/  function  to  invoke 
an  ECS  task  (that  runs  the  container  (that  runs  the  iiif- 
process  tool)). 

If  you're  not  sure  what  "Lambda  function"  means  think  of  it  as  an  atomic  piece  of 
code  that  can  be  invoked  on-demand;  sort  of  like  a  "baby-container"  with  fewer 
capabilities. 


That's  a  lot  to  digest  so  here's  a  handy  diagram  to  show  how  everything  fits 
together  images/process-arch,  jpg  and  where  the  layers  of  separation  are 
defined.  Simple,  right? 


•  The  yellow  boxes  represent  software  in  the  actual  go-iiif  # 
package,  as  well  as  its  dependencies . 

•  The  blue  boxes  are  Docker-related  "wrappers";  all  the  things  that 
handle  creating  a  virtual  computer  that  can  run  the  go-iiif 
software. 

•  The  pink  boxes  are  the  AWS-related  wrappers  (around  the  Docker 
wrappers)  as  well  the  different  " entry  points"  to  run  the  go-iiif 
software  inside  Amazon  's  data  centers. 


I  sometimes  joke  that  Docker  is  a  "flannel  shirt"  on  top  of  go-iiif  and  AWS 
a  "big  fuzzy  sweater"  on  top  of  Docker.  There  are  two  reasons  for  structuring 


things  this  way: 


First,  an  ECS  task  is  effectively  a  shrink-wrapped,  on-demand  computer  (whose 
specifics  are  defined  by  a  Dockerf  ile)  that  can  be  spun  up  to  do  some  work 
(like  processing  images)  and  then  torn-down  as  soon  as  the  work  is  done . 


You  can  run  multiple  ECS  tasks  in  parallel,  independent  of  one  another,  and  you 
are  only  billed  for  the  time  they  are  running.  This  is  a  lot  cheaper  than  running  one 
or  more  always-on  computers  inside  AWS  and  a  lot  easier  than  having  to  manage 
a  large  workload  across  those  machines  yourself.  Since  every  image  handled  by 
iiif-process  is  producing  multiple  derivatives  and  any  one  computer  only 
has  a  finite  number  of  processors  there  is  a  lot  to  be  said  for  letting  Amazon 
schedule  and  allocate  multiple  tasks  in  the  available  margins  of  all  the  servers  and 
processors  they're  already  operating. 


Second,  AWS  compliments  go-iiif  and  makes  a  lot  of  things  easier  and 
cheaper  but  AWS  does  not  become  a  requirement  in  order  to  use  go-iiif. 


You  can  migrate  your  Docker-related  scaffolding  to  another  cloud  computing 
service  or  simply  run  things  on  your  own  server  infrastructure  should  you  choose 
to  do  so. 

This  part  is  really,  really  important.  Docker-based  containers  have  become  a  sort 
of  lingua  franca  for  defining  and  packaging  virtual  computers.  It's  a  standard 
common  to  all  the  "cloud  services"  companies  so  that  helps  prevent  vendor  lock- 
in.  Although  I  keep  saying  "Amazon"  and  "AWS",  and  while  some  things  like 
ECS  tasks  or  Lambda  functions  are  AWS  specific,  it  should  still  be  possible  to  use 
the  actual  iiif-process  tool  with  a  Google  Cloud  or  Microsoft  Azure  or 
equivalent. 


Even  if  Docker  or  Dockerfiles  go  "sour"  they  are  ultimately  just  one  way  to 
package  containers  (virtual  computers)  among  many.  At  the  end  of  the  day  if  a 
packaging  standard  can  make  a  container  that  looks  and  feels  and  runs  like  a  plain- 
vanilla  Unix  computer  then  the  ability  to  use  the  go-iiif  toolchain  is  preserved. 


It  is  easy  to  get  distracted  by  the  allure  of  very  real  budget  savings  and  reduced 
infrastructure  overhead  that  cloud-or-serverless-or-just-not-your-own-machines 
style  computing  offers.  It  is  equally  important,  especially  for  cultural  heritage 
institutions,  to  have  some  idea  of  how  things  will  keep  working  if  a  vendor 
becomes  unreliable  or  worse  predatory. 

A  larger  conversation 


Installation  view  of " The  Modern  Consumer  -  1950s  Products  and  Styles " ,  2018.  Photo  by  SFO  Museum. 


What  all  of  this  points  to  is  a  much  larger  and  on-going  conversation  about  the 
pros  and  cons,  and  risks,  of  outsourcing  general  purpose  computing  to  services 


like  Amazon.  There  are  a  lot  of  opinions  and  just  as  many  unique  scenarios  that 
dictate  the  choices  people  make.  Somewhere  between  "All  in!"  and  "It's  just  a  tool 
of  The  Man  designed  to  keep  you  down"  lies  the  reality. 


Recently  I've  been  pointing  people  to  Tim  Bray's 

Server  leSSneSS  https : //www. tbray . org/ongoing/When/201x/2  018/ 12/09 /Ser 
verlessness  blog  posts.  Tim  works  for  AWS  and  these  blog  posts  are  the  by¬ 
product  of  an  hour-long  talk  he  did  last 

year  https: //www. youtube. com/watch?v=iP0vrK3S3gQ  explaining  the 
benefits  of  letting  Amazon  run  the  servers  (computers)  that  power  your  services. 
Tim's  arguments  are  not  disinterested  but  he  makes  good  points  in  AWS'  favour 
and  is  refreshingly  frank  about  the  remaining  stress-points. 


A  valuable  counterpoint  to  Tim  is  David  Rosenthal's  Cloud  For 
Preservation  https ://blog.dshr.org/2019/0  2 /c loud- f or- 
preservation .  html  .  This  is  a  very  long  blog  post  and  focuses  mostly  on  data 
storage  but  is  absolutely  worth  reading  and  the  general  concerns  he  raises  can  be 
applied  to  most  aspects  of  "cloud"  computing. 


If  you  have  the  time,  go  read  those  blog  posts  and  watch  the  videos  now  before 
life  gets  in  the  way.  I'll  wait. 


Processing  images  from  the  command  line 


Here  are  three  random  images  of  The  Modern  Consumer  -  1950s 
Products  and  Styles 

There  are  46  images  of  this  exhibition  /  or  just  jump  to  random  image 


Installation  view  of  "The  Modern 
Consumer  -  1950s  Products  and 
Styles" 

Image  by  SFO  Museum.  It  was 
taken  on  Dec  20,  2018. 


Installation  view  of  "The  Modern 
Consumer  -  1950s  Products  and 
Styles" 


Image  by  SFO  Museum.  It  was 
taken  on  Dec  20,  2018. 


Installation  view  of  "The  Modern 
Consumer  -  1950s  Products  and 
Styles" 

Image  by  SFO  Museum.  It  was 
taken  on  Dec  20,  2018. 


So,  how  does  all  of  this  work? 


iiif-process  is  a  command-line  tool  so  you  invoke  it  from  your  computer's 
"terminal"  application  passing  it  the  path  to  a  (IIIF)  configuration  file,  an 
"instructions"  file  and  one  or  more  images  to  process. 


For  example: 


$>  . /bin/iiif-process  -config  config.json  -instructions  instructions . j son  -uri  source/ IMG_00 84 .JPG 

Reminder:  Both  the  root  of  your  source  images  and  the  location  where  derivatives 
are  created  are  both  defined  in  the  IIIF  config  file  https  : //github.com/go- 
iiif /go- iiif#config- files 


"Instructions"  files  are  JSON-encoded  dictionaries  of  user-defined  labels  and  one 
or  more  IIIF  Image  API  https : //iiif . io/api/image/2 . 0/#image-request- 


parameters  image  request  parameters.  There  is  no  limit  (beyond  what  your 
servers  can  handle)  to  the  number  of  instructions  you  can  define  in  a  single  file. 


Here's  what  the  contents  of  the  instructions  file  in  the  example  above  looks  like: 


{ 

"o" :  {"size":  "full",  "format":  " " ,  "rotation":  "-1"  }, 

"b":  {"size":  "!  2048 , 1536 " ,  "format":  "jpg"  }, 

"d" :  {"size":  "full",  "quality":  "dither",  "region":  "-1,-1,320,320",  "format":  "jpg"  } 

> 

This  tells  iiif-process  to  create  a  copy  of  the  original  file  (o),  a  scaled 
version  with  maximum  dimensions  of  2048  or  1536  pixels  (b)  and  a  square- 
cropped  thumbnail  320  pixels  to  a  side  that  has  been  halftoned  (d). 


Strictly  speaking  these  are  go-iiif  image  request  parameters  since  non¬ 
standard  flags  like  quality=dither  or  rotation— 1  are  accepted.  These 
were  introduced  in  version  1.1  of  go-iif  and  are  discussed  in  detail  in  the  Using 
IIIF  at  SFO 

Museum  https : //millsfield. sfomuseum.org/blog/2018/07/18/iiif/ 
blog  post. 


Here's  the  final  output  of  the  iiif-process  process: 


{ 

" source/ IMG_0084 . JPG" :  { 
"dimensions":  { 

"b":  [ 

2048, 

1536 

], 

"d":  [ 

320, 

320 

], 

"o" :  [ 

4032, 

3024 

] 

}, 

"palette":  [ 


"name":  "#b87531", 
"hex":  "#b87531" , 
"reference":  "vibrant" 


}, 

{ 

"name":  "#805830", 

"hex":  "#805830", 

"reference":  "vibrant" 

}, 

{ 

"name":  "#7a7a82", 

"hex":  "#7a7a82", 

"reference":  "vibrant" 

}, 

{ 

"name":  "#c7c3b3", 

"hex":  "#c7c3b3", 

"reference":  "vibrant" 

>, 

{ 

"name":  "#5c493a", 

"hex":  "#5c493a", 

"reference":  "vibrant" 

} 

]/ 

"uris" :  { 

"b" :  " source/IMG_0084 . JPG/full/ !2048, 1536/0/color. jpg" , 

"d" :  " source/ IMG_00 84 . JPG/-1 , -1 , 320 , 32 0 /f ull /0/dither . jpg" , 
"o" :  " source/IMG_0084 .JPG/ full/ full /-I /color . jpg" 

} 

} 

} 


Every  response  will  contain  a  key  whose  value  is  the  name  of  the  image  you  asked 
to  process  and  whose  value  will  be  a  dictionary  with  at  least  two  keys: 
dimensions  and  uris. 


These  represent  the  sizes  and  paths  for  the  each  of  the  derivative  images  and  their 
values  are  also  dictionaries  whose  own  keys  map  to  the  keys  defined  in  your 
"instructions"  file. 


In  this  example  we've  also  configured  go-iiif  to  extract  colour 

information  https://github.eom/go-iiif/go-iiif#palette  for  the  source 
image  so  that  information  is  encoded  in  the  palette  response  key. 


What  you  don't  see  in  these  examples  is  that  all  three  of  the  derivative  images  (b , 
d  and  o)  were  processed  and  stored  concurrently,  taking  advantage  of  all  the 
processors  that  a  computer  running  iiif-process  has  at  its  disposal. 


Amazon,  for  example,  has  lots  and  lots  and  lots  of  processors  at  its  disposal.  The 
good  news  is  that  we  can.  The  bad  news  is  that  doing  so  is  a  bit  like  putting  on  a 
snow  suit  to  go  outside  in  the  winter;  there  are  many  steps,  it's  a  bit  awkward  and 
the  closer  you  get  to  reaching  the  outdoors  the  more  uncomfortable  it  becomes. 

Processing  images  as  ECS  tasks,  from  the  command  line 


Installation  view  ( cropped  and  half  toned)  of  "Reflections  in  Wood  -  Surfboards  &  Shapers" ,  2019.  Photo  by  SFO  Museum. 


As  mentioned  earlier  there  is  a  second  tool  called  iiif-process-ecs.  It  is  a 
helper-tool  designed  to  invoke  a  copy  of  iiif -process  that's  been  embedded 
in  a  Docker  container  along  with  a  configuration  hie  and  an  instructions  hie ,  and 
that  is  run  as  a  "task"  on  Amazon's  servers. 


Remember,  Dockerhles  allow  you  to  create  bespoke  shrink-wrapped  virtual 
computers  and  ECS  will  inhate  those  "computers"  on  demand,  run  software 
installed  on  them  and  then  shut  everything  down.  The  details  of  creating  a  iiif- 
process  Dockerhle  and  of  conhguring  it  for  use  in  AWS  are  covered  in  the  go- 


iiif-aws  documentation  https://github.eom/go-iiif/go-iiif-aws#ecs  but 
the  result  is  a  container  with  both  software  and  configuration  files  pre-installed. 


In  order  to  process  the  same  source/ IMG_0 084  .  JPG  in  the  example  above  as 
an  ECS  task  you  would  invoke  the  iiif-process-ecs  tool  like  this: 


$>  iiif-process-ecs  -mode  task  \ 

-ecs-dsn  ' region={AWS_REGION}  credentials={AWS_CREDENTIALS} '  \ 
-subnet  {AWS_SUBNET}  \ 

-security-group  {AWS_SECURITY_GROUP}  \ 

-cluster  iiif-process-ecs  -container  iiif-process-ecs  \ 

-task  iiif-process-ecs : 1  \ 

-uri  source/ IMG_0 084 .JPG 


And  the  output  would  be  something  like  this: 


2019/01/30  15:30:01  arn : aws : ecs : {AWS_REGION} : {AWS_ACCOUNT_ID> :task/{ECS_TASK_ID} 

As  of  this  writing  the  iiif-process-ecs  exits  as  soon  as  the  ECS  task  is 
registered  but  not  necessarily  completed.  It  is  left  up  to  you  ask  AWS  whether  the 
task  is  complete .  This  isn't  ideal  and  one  reason  that  the  go-iiif- 
aws  https: //github.com/go-iiif /go-iiif-aws  package  is  only  considered 
to  be  a  0 . 0 . 1  release. 


The  other  thing  you  might  notice  is  that  there  is  no  output  like  there  is  in  the 
command- line  example.  This  is  also  on  the  "to  do"  list  and  wrapped  up  in  the 
details  of  an  entirely  other  AWS  service  called  CloudWatch  (vendor  lock-in, 
anyone?)  that  manages  when  and  where  the  output  of  an  ECS  task  is  recorded 


The  normal  iiif-process  output  will  eventually  be  sent  to  CloudWatch  but 
we  haven't  written  the  code  to  extract  it  yet.  We'd  love  some 
help  https://github.com/go-iiif/go-iiif-aws/issues  if  you  are 
comfortable  writing  code  in  Go. 


The  alternative  is  to  invoke  the  iiif-process-ecs  tool  with  the  -report 
flag.  This  flag  will  get  passed  down  to  the  iiif-process  tool  which  instructs 
the  code  to  store  a  JSON-encoded  copy  of  the  response  details  to  the  same 
location  as  your  derivative  images  https://github.com/go-iiif/go- 
iiif#imagescache  . 


Here's  an  abbreviated  example: 


$>  iiif-process-ecs  -mode  task  \ 
-report  \ 

-report-name  process. j son  \ 
-uri  source/ IMG_0 084 .JPG 


Which  would  cause  the  following  files  to  be  created: 


source/ IMG_0 084 . JPG/full/ 12048, 1536/0/color. jpg 
source/IMG_0084 . JPG/-1 , -1,320, 320 /full/ 0/dither . jpg 
source/ IMG_0 084 .JPG/ full / full /-I /color . jpg 
source/ IMG_0 084 . JPG/process . json 

Again,  this  is  not  ideal  but  it  does  prevent  AWS-specific  infrastructure  from 
worming  its  way  in  to,  and  becoming  a  dependency  of,  the  core  go-iiif 
codebase.  In  the  short-term  it  is  understood  to  be  an  acceptable  trade-off. 


Processing  images  as  ECS  tasks,  from  S3 


Installation  view  ( cropped )  of  "Reflections  in  Wood  -  Surfboards  &  Shapers" ,  2019.  Photo  by  SFO  Museum. 


You  can  also  set  up  the  iiif-process-ecs  tool  to  run  as  an  AWS  Lambda 
function  to  be  triggered  when  someone  uploads  a  new  file  to  an  S3  bucket.  The 
details  of  setting  up  a  iiif-process-ecs  Lambda  function  are  best  left  to  the 
go-iiif-aws  documentation  https://github.com/go-iiif/go-iiif- 
aws#running-iiif-process-ecs-as-a-lambda-function  but  the  end  result  is 
that  you  are  basically  asking  Amazon  to  do  this  (again,  abbreviated)  when 
someone  uploads  new  file: 


$>  iiif-process-ecs  -mode  task  \ 

-uri  F I LE_TH AT_ JU S T_GOT_UPLOADE D_TO_S  3 

What  happens  after  the  iiif-process  task  is  completed  is  outside  the  scope  of 
the  Lambda  function.  You  will  need  to  account  for  that  in  a  separate  piece  of 
Code  https: //github.com/go-iiif/go- 

iiif /blob/master /process/parallel .  go  .  Because  the  Lambda  function  is  just 
invoking  the  ECS  task  all  the  caveats  about  return  values,  discussed  above,  apply 
here  too. 


Magic,  right?  http:  //lifewinning. com/magic /bibliography/  Not  quite,  if 
we're  being  honest  (or  if  you're  the  person  who  has  to  set  this  up)  but  it's  a  start. 

Wrapping  it  up  (for  now) 


Installation  view  (halftoned)  of  " Reflections  in  Wood  -  Surfboards  &  Shapers" ,  2019.  Photo  by  SFO  Museum. 


The  actual  iiif-process  https://github.com/go-iiif/go- 
iiif /blob/master /cmd/iiif-process  .  go  tool  is  part  of  the  main  gO-iiif  # 
package,  which  itself  has  been  moved  in  to  a  newly  created  go-iiif 
organization  https :  //github.com/go-iiif  on  GitHub.  If  you  are  already 
using  go-iiif  in  your  code  you  will  need  to  update  your  import  paths 
accordingly. 


All  of  the  AWS  specific  code,  including  Dockerfiles,  is  part  of  a  standalone  go-iiif- 
aws  https://github.com/go-iiif/go-iiif-aws  package. 


There's  also  another  go-iiif-uri  https://github.com/go-iiif/go-iiif-uri 
package  that  the  first  two  use.  There  is  also  a  dedicated  package  for  URIs  because 
even  though  we  are  using  go-iiif  to  process  images  we  don't  want  our  final 
images  URLs  to  look  like  this: 


source/ IMG_0 084 . JPG/-1 , -1,320, 320 /full/ 0 /dither .jpg. 


We  want  them  to  look  like  this,  instead: 


137/689/158/3/137689 1583_MfZTKW2yvlcsD2j6Xb53m7UCtHkC8YFi_sd.  jpg 

We  use  the  go-iiif-uri  package  to  accomplish  this,  but  we'll  save  that  for  a 
future  blog  post. 


Everything  described  in  this  blog  post  is  code  we've  begun  using  in  earnest  to  start 
working  through  the  backfill  of  installation  photos  for 

exhibitions  https : //millsf ield. sfomuseum. org/blog/20 19/01 /02 /surf ace 
/  .  For  any  given  image  we  generate  (10)  derivative  images. 


{ 


> 


"o":  {"size":  "full",  "format":  "rotation":  "-1"  }, 

"k":  {"size":  "! 2048 , 1536 " ,  "format":  "jpg"  }, 

"b":  {"size":  "11024, 768",  "format":  "jpg"  }, 

"c":  {"size":  "1800,600",  "format":  "jpg"  }, 

"dc":  {"size":  "1800,600",  "quality":  "dither",  "format":  "jpg"  }, 

"z":  {"size":  "1640,480",  "format":  "jpg"  }, 

"n":  {"size":  "1320,240",  "format":  "jpg"  }, 

"s":  {"size":  "full",  "region":  "-1,-1,320,320",  "format":  "jpg"  }, 

"ds":  {"size":  "full",  "quality":  "dither",  "region":  "-1,-1,320,320",  "format":  "jpg"  } 


All  the  images  for  the  recent  Reflections  in  Wood  -  Surfboards  & 

Shapers  https : //mil Is field. sfomuseum.org/exhibitions/1376812931/im 
ages/  ,  The  Modern  Consumer  -  1950s  Products  and 

Styles  https : //mills field. sfomuseum.org/exhibitions/1360702457/imag 

es/  and  A  Sterling  Renaissance,  British  Silver  Design  1957- 

2018  https  : //millsf ield. sfomuseum.org/exhibitions/1360667837/ 


exhibitions  have  been  generated  using  this  code  in  a  fraction  of  the  time  (and  a 
fraction  of  the  cost)  that  doing  so  on  a  standalone  server  would  have  taken. 


Installtion  view  ( cropped )  of " A  Sterling  Renaissance,  British  Silver  Design  1957-2018" ,  2018.  Photo  by  SFO  Museum. 


Our  overall  image  processing  workflow  is  more  complicated  than  the  iiif- 
process  tool  alone,  and  we  are  still  working  out  the  kinks,  but  it  is  the 
foundational  layer  for  everything  else  we're  doing.  We  also  think  this  is  work  that 
can  be  used  to  improve  the  time  it  takes  to  generate  the  tiles  that  power  zoomable 
image  interfaces  https://go-iiif.github.io/go-iiif/ 

We're  pleased  to  make  our  contributions  available  to  others  in  the  sector  and  we 
hope  that  others  will  find  them  as  useful  as  we  do. 


2019-02-12 


the  internet  we  deserve 


Who's  On  First  globes 


Who's  On  First  globes 


I've  start  making  globes.  Just  little  ones  to  begin,  only  six  inches  in 
diameter,  and  I  am  not  worrying  too  much  about  making  them  pretty  or 
elegant  yet.  I  wanted  to  see  whether  I  could  do  it  at  all.  What  follows  are 
the  steps  and  instructions  I  cobbled  together,  from  different  corners  of 
the  internet,  to  make  a  printed  globe  using  open  data  and  open  source 
software. 


Getting  started 

There's  no  way  around  the  fact  that  making  map  gores  requires  installing 
a  backyard  swimming  pool's  worth  of  dependencies.  The  good  news  is 
that  everything  is  available  in  one  or  more  of  the  many  "package 
managers"  out  there.  If  you  haven't  already  run  away  in  fear  at  the 
mention  of  the  phrase  "package  manager"  there  is  an  equal  amount  of 
technical  jargon  you'll  need  to  weather  to  get  anything  done. 


As  far  as  dependencies  go  everything  that  follows  could  be  wrapped  up 
in  a  container  format  like  Docker  https :  / /docker .  com/  which 
would  reduce  the  number  of  steps  from  "many"  to  "download  a  single 
500MB  application  with  risky-to-dubious  permissions  requirements  but 
has  a  cute  desktop  icon  you  can  click  on".  One  step  at  a  time. 

Data  (Who's  On  First) 

There  is  nothing  Who's  On  First  https://whosonfirst.org/ 

(WOF)  specific  about  these  globes.  Any  data  source  will  do  assuming 
you  can  wrangle  it  in  to  a  spatial  database  or  format.  Since  I  spend  a  lot 
of  time  working  on  WOF  I  thought  it  would  be  good  to  see  whether  I 
could  actually  make  something  with  all  that  data.  It's  been  a  good  way  to 
spot  outstanding  issues  https  :  //github .  com/whosonf  irst- 
data/whosonf  irst-data/ issues/1475  in  WOF. 


wof-shapefile-index 


The  first  step  is  to  take  WOF  data  and  convert  it  in  to  (ESRI)  shapefiles. 
Shapefiles  are  not  the  only  option.  They  were  just  easy.  I  am  using  the 
Mapnik  rendering  engine  https :  / /mapnik .  org/  to  draw  the  map 
and  it  can  be  configured  to  work  with  a  variety  of  data  sources.  Support 
for  shapefiles  is  enabled  by  default  in  Mapnik  and  doesn't  require  setting 
up  a  standalone  database  so  laziness  won  the  day.  I  have  also  been 
working  on  tools  to  create  shapefiles  from  raw  WOF 

data  https : //github . com/whosonf irst/go-whosonf irst- 
shapefiie  so  this  was  a  good  way  to  test  them  out. 


In  order  to  use  the  go-whosonf  irst-shapef  ile  tools  you  will 
need  to  have  the  Go  https :  //goiang .  org  programming  language 
installed.  You  will  also  need  to  install  the  git,  make  and  gcc  tools.  All 
four  are  available  in  most  package  managers  but  I  prefer  to  install  Go 
from  source  since  the  package  managers  are  typically  out  of  date  by  a 
few  releases . 


The  first  step  is  to  download  and  compile  the  go-whosonf  irst- 
shapef  ile  package: 


git  clone  https : / / github.com/whosonfirst/go-whosonfirst-shapefile . git 
cd  go-whosonf irst-shapef ile 
make  bin 


Once  that's  done  so  I  can  create  shapefiles  from  WOF  data  using  the 
wof-shapef  ile-index  tool  like  this: 


$>  . /bin/wof-shapef ile-index  -out  wof.shp  -shapetype  POLYGON  -mode  meta  \ 
wof— continent— latest . csv  \ 
wof— country— latest . csv  \ 
wof-region-latest .csv 

What's  going  on  here?  I  am  asking  the  wof-shapef  ile-index  tool 
to  create  a  shapefile  called  wof .  shp  with  all  the  data  found  in  one  or 
more  WOF  "meta"  files.  Meta  files  are  just  CSV  files  with  a  specific 
subset  of  WOF  records,  in  this  case  continents  and  countries  and  regions. 
Again  this  was  just  for  the  sake  of  expediency. 


The  core  whosonf  irst-data  set  has  gotten  quite  big  (like  4.8M 
records  of  which  about  two  million  are  localities)  so  plowing  through  all 
those  extra  records  didn't  seem  worth  it.  I  also  happened  to  have  pre¬ 
generated  the  meta  files.  Meta  files  are  not  included  with  WOF  data  but 


there  is  a  handy  tool  for  generating  them  included  with  every  data  repo. 
For  example: 


$>  git  clone  https://github.com/whosonfirst-data/whosonfirst-data.git 
. . . time  passes 
...time  keeps  passing 

...time  keeps  on  slipping  slipping  slipping  in  to  the  future 

$>  cd  whosonf irst-data 

$>  make  metafiles 

. . .more  time  passes 

$>  Is  -la  metafiles 

metaf iles/wof-continent-latest . csv 

. . . and  so  on 

None  of  this  happens  quickly.  The  whosonf  irst-data  repository  is 
already  very  very  large  (it's  huge  in  a  too-too-big  kind  of  way,  really)  and 
has  an  even  larger  Git  history  file  so  everything  takes  a  while  just  to 
download.  Just  generating  the  meta  files  takes  10-15  minutes  on  a 
modern  laptop.  The  world  is  a  big  place. 


A  better  alternative  for  most  people  is  to  download  the  WOF  SQLite 
distributions  https://dist.whosonfirst.org/sqlite/  that  are 
created  (usually  nightly)  from  the  most  recent  data  in  the  whosonfirst- 
data  repositories  https://github.com/whosonfirst-data  .You'll 
also  need  to  make  sure  you've  installed  the  bunzip2  utility  to 
uncompress  the  data  (that's  what  the  -  j  flag  in  the  command  below  is 
for). 


$>  wget  https : //dist . whosonf irst . org/ sqlite/whosonf irst-dat a- latest . db . tar .bz2 
$>  tar  -xjf  whosonfirst-data-latest.db.tar.bz2 


Now  it's  possible  to  generate  a  new  shapefile  from  the  data  in  the  SQLite 
database,  passing  the  -mode  sqlite  and  multiple  -include- 
placetype  flags  to  the  wof-shapef  ile-index  tool.  Like  this: 

$>  wof-shapef ile-index  -out  wof.shp  -shapetype  POLYGON  -mode  sqlite  \ 
-include-placetype  continent  \ 

-include-placetype  country  \ 

-include-placetype  region  \ 
whosonf irst-data-latest . db 

Note:  For  the  sake  of  brevity  all  of  these  examples  assume  relative  paths 
so  you  will  need  to  adjust  things  according  to  where  they  are  found  on 
your  computer. 

Maps 


Mapnik  and  nik2img.py  (and  pip) 

I  am  using  Dane  Springmeyer's  handy 

nik2img.py  https://github.com/springmeyer/nik2img  tool  to 
render  the  shapefile  as  an  image.  Dane's  tool  depends  on  Mapnik,  and 
specifically  the  Mapnik  Python  bindings. 


On  a  Mac  with  the  Homebrew  https :  /  /brew .  sh  package  manager 
installed  it's  pretty  straighforward.  You'd  just  type: 


$>  brew  install  mapnik 

On  a  Linux  machine  you  would  type: 


$>  apt-get  install  python-mapnik  pip 

apt -get  is  the  package  manager  that  comes  with  Ubuntu.  If  you're 
using  a  RedHat  variant  you  would  replace  apt-get  with  yum.  I  am  not 
sure  what  you  do  on  a  Windows  machine  but  as  I  write  this  Homebrew 
is  now  available  for  both  Windows  and  Linux  operating 
systems  https://brew.sh/2019/02/02/homebrew-2. 0.0/  so  maybe 
that  is  the  easiest  thing  these  day? 


Did  you  notice  the  way  I  am  also  installing  something  called  pip  in  the 
Linux  example?  pip  is  itself  a  package  manager  for  Python 
libraries  https : //packaging . python . org/ guides /tool- 
recommendations/  .  On  a  Mac  you  might  need  to  install  it  by  installing 
the  Homebrew  version  of  Python  itself  but  I  am  hesitant  to  suggest 
anything  involving  Python  on  a  Mac  since  there  are  so  many  ways  to 
mess  things  up  because  everyone's  Python  installation  is  a  special 


snowflake  https://xkcd.com/i987/  .  It's  all  do-able,  it's  just  a 
different  set  of  steps  for  each  person. 


In  the  end  you  want  to  be  able  to  run  the  following  command: 


$>  pip  install  nik2img 

Which  will  install  a  command  line  tool  called  nik2  img .  py  on  your 
computer,  which  can  be  run  like  this: 


$>  nik2img.py  map. xml  map. png  — bbox  -180  -90  180  90  — dimensions  3600  1800 

Above,  I  am  asking  nik2  img .  py  to  create  a  new  image  called 
map .  png  depicting  the  entire  world  and  whose  dimensions  are  3600  x 
1800  pixels,  or  12  inches  by  6  inches  at  300  dot  per  inch.  I  am  also 
telling  nik2  img .  py  to  look  for  all  its  data  and  styling  configurations  in 
a  file  called  map .  xml.  I  am  not  going  to  get  in  to  the  details  of  Mapnik 
style  definitions  here  since  they  are  well  documented 
elsewhere  https : //github . com/mapnik/mapnik/wiki/XMLConf igRef 
erence  .  Here's  what  the  Mapnik  style  document  I  used  to  create  my 
first  globe  looks  like: 


<Map  background-color="#D5F4F8 "  srs="+pro j=longlat  +ellps=WGS84  +datum=WGS84  +no_defs"> 
<Style  name="WOF"> 

<Rule> 

<PolygonSymbolizer  f ill="#f 4ef 74 " /> 

CLineSymbolizer  stroke="#f 11499 "  stroke-width=" 1 "  /> 

</Rule> 

</Style> 

<Layer  name=" vector "  srs="+pro j=longlat  +ellps=WGS84  +datum=WGS84  +no_defs"> 
<StyleName>WOF</ StyleName> 

<Datasource> 

<Parameter  name= " type " >shape</Parameter> 

<Parameter  name=" f ile">wof . shp</Parameter> 

</Datasource> 

</Layer> 

</Map> 


See  all  the  srs="  +pro  j  = .  .  . "  stuff?  This  tells  Mapnik  that  I  want  to 
create  a  map  using  the 

WSG84  https  : //en.  wikipedia.org/wiki/EPSG:  4326  projection, 
sometimes  called  EPSG :  4  3  2  6 .  Discussions  of  map  projections  are  a  bit 

of  a  black 

hole  https : //www. aaronland. info /weblog/ 2 019/ 02/11/ joy /#maps 

but  if  you're  curious  to  learn  more  Lyzi  Diamond's  EPSG  4326  vs  EPSG 
3857  (projections,  datums,  coordinate  systems,  and 

more!)  http://lyzidiamond.com/posts/4326-vs-3857  is  a  good 
place  to  start.  The  point  is  to  create  a  map  using  a  Simple 
Cylindrical  http: //northstar- 

www. dartmouth . edu/doc/ idl/html_6 . 2/Cylindrical_Pro jections . 
html  projection. 

gdal_translate 

The  next  step  is  to  convert  the  PNG  image  in  to  a  geo-referenced  TIFF 
(or  GeoTIFF)  file  emebedding  the  extent  of  the  map  (the  whole  world) 
and  the  map  projection  we're  using  (WSG84).  This  is  done  using  the 
gdal_translate  utility  which  is  installed  as  part  of  the  larger 
GDAL  toolchain  https :  //gdai .  org/  which  is  used  by  Mapnik  so  it 
should  already  be  installed.  Note  the  -a_sr s  EPSG :  4 2 3  6  flag.  That's 
just  another  way  of  saying  "This  is  using  the  WGS84  projection." 

$>  gdal_translate  -of  Gtiff  -a_ullr  -180  -90  180  90  -a_srs  EPSG: 4236  map. png  map. tiff 


Globes 


gdal2gores.py 


I  use  Trent  Hare's  gdal2gores.py  https :  //github.com/usGS- 
Astrogeology/GDAL_scripts/blob/master/gdal2Gores/gdal2gores 
.  py  utility  to  convert  the  rectangular  map  in  to  a  series  of  map  "gores" . 
In  other  words  we  take  a  rectangular  map  and  turn  it  in  to  a  bunch  of 
equal- width  "orange  peels".  Hare  writes: 


Given  a  Simple  Cylindrical  map  projected  image  remap 
to  an  image  with  n  gores  for  placing  map  or  printing  map 
on  a  sphere  (e.g.  tennis  ball).  I'm  sure  this  could  be 
optimized! 


gdal2gores  .  py  depends  on  the  Python  bindings  for  GDAL  to  be 
installed.  I'm  a  little  hazy  about  which  package  manager  installs  which 
Python  bindings  for  which  low-level  libraries.  On  a  Linux  machine  you 
may  need  to  apt-get  install  python-gdal  in  order  for  this  to 
work. 


$>  gdal2gores . py  -ng  16  ./map. tiff  . /map-gores . jpg 

And  then,  finally,  I  have  16  distinct  map  gores  that  I  can  print  and  cut  out 
and  glue  to  a  sphere.  I've  been  going  to  the  local  fabric  store  and  buying 
cheap  foam  balls  to  work  with.  Anything  larger  than  6  to  8  inches  starts 
to  get  more  expensive  than  you  think  it  should  so  I  might  investigate 
papier-mache  https  :  //en  .Wikipedia .  org/wiki/Papier- 
m%c3 %A2ch%c3 %A9  -ed  balloons,  notwithstanding  the  challenge  of 
inflating  a  perfect  sphere. 


Here's  what  I've  learned  so  far: 


•  32  or  more  gores  are  best  for  a  6"  globe.  16  gores  are  okay 
but  not  great  and  8  gores  don't  work  at  all.  Because  of  the 
way  you  have  to  pinch  the  paper  to  fit  the  sphere  you  end  up 
with  gaps  in  the  final  globe. 


•  gdal2 gores .  py  doesn 't  draw  outlines  around  the  map 
gores.  If  you've  styled  your  land  cover  to  be  white  and 
you're  printing  them  on  white  paper  it  can  be  hard  to  see 
where  to  cut  the  gores  around  the  poles.  I  might  try  patching 
the  code  to  draw  the  gores  on  a  textured  background  to 
make  it  easier  to  cut  things  out. 

•  It's  very  easy  to  mess  up  the  poles  when  gluing  map  gores  to 
a  globe.  Sorry,  Antarctica. 

•  Glue  sticks  are  awesome. 


At  some  point,  I  would  like  to  investigate  marrying  Peter  Richarson's 
work  to  support  different  (non-web-map)  projections  in  the  Tangram 
rendering  engine  https://www.mapzen.com/blog/escape-from- 
mercator/  with  the  LA  Times'  Web  Map 

Maker  https://github.com/datadesk/web-map-maker  tool  used  to 
generate  static  images  of  maps  rendered  with 

Tangram  https://www.mapzen.com/products/tangram/  .  (As  I 
write  this  most  of  the  inline  maps  in  Peter's  blog  post  are  broken  but  they 
work  if  you  follow  the 

links  https : //meetar . github . io/ projection-tests/? 
katamari . yami#i5/ 40.7467/-73.9889  .)  In  the  meantime  I've  been 

keeping  notes  and  examples  and  tools  in  a  whosonfirst- 
globe  https://github.com/aaronland/whosonfirst-globe  repo  on 
GitHub.  Suggestions  and  improvements,  particularly  around  setting  up 
dependencies  for  all  the  different  operating  systems,  would  be  welcome. 


Globes! 


2019-02-21 


things  I  have  written  about 
elsewhere  #201 90226 

People  Looking  at  Art  at  SFO  (1982  -  2019) 


People  Looking  at  Art  at  SFO 
(1 982  -  201 9) 


Bowling:  A  Unique  American  Art  Form ,  D-04  Center  Gallery  (1991 ) 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : / /millsf ield . sfomuseum.org/blog/2019/ 02/26/ 
people/  ,  in  February  2019. 


A  Medley  of  Skates  and  Memorabilia,  B-04  Entrance  Lobby  B  (1997) 


Building  for  Air  Travel,  D-01  Central  North  Connector  (1997) 


Barbie®  Takes  A  Vacation  to  Exotic  Places,  A-03  Entrance  Lobby  A  ( 1996) 


Barbie®  Takes  A  Vacation  to  Exotic  Places,  A-03  Entrance  Lobby  A  ( 1996) 


B  is  for  Bears,  A-03  Entrance  Lobby  A  (1993) 


Ancestor  Figures  from  New  Guinea  D-05  Central  South  Connector  (1993) 


Airport  Cafe,  F -02  North  Connector  (1986) 


Before  the  21st  Century:  An  Ode  to  Boats,  Cars,  Motorcycles,  Planes,  and  Trains,  F-02  North  Connector  ( 1992 ) 


Before  the  21st  Century:  An  Ode  to  Boats,  Cars,  Motorcycles,  Planes,  and  Trains,  F-02  North  Connector  ( 1992 ) 


Artist's  Furniture:  New  Dimensions  and  Statements  in  Design,  F-02  North  Connector  (1982) 


Art  and  Travel,  F-02  North  Connector  ( 1984) 


Boomerang,  F-02  North  Connector  (1996) 


San  Francisco,  From  the  David  Rumsey  Map  Collection,  D-12  Wall  Case  (2013) 


The  Art  of  Recology:  The  Artist  in  Residence  Program  1990-2013 ,  F-02  North  Connector  (2013) 


The  Flight  Bag:  Icon  of  Air  Travel,  A-03  Entrance  Lobby  A  (2003) 


Classic  Plastics:  1870s-1970s,  A-02  International  South  Cases  (2013) 


Architectural  Building  Block ,  D-05  Central  South  Connector  ( 1994) 


The  Modern  Consumer  -  1950s  Products  and  Styles,  F-02  North  Connector  (2018) 


The  Lunar  Year:  Artifacts  and  Tradition,  C-03  Entrance  Lobby  C  (1997) 


Reflections  in  Wood  -  Surfboards  &  Shapers ,  A-01  International  South  Wall  (2019) 


2019-02-26 


things  I  have  written  about 
elsewhere  #201 90301 

Headers,  menus  and  feeds  -  A  quick  update 


Headers,  menus  and  feeds  - 
A  quick  update 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : / /mills field . sfomuseum.org/blog/2019/ 03/01/ 
update/  ,  in  March  2019. 


As  you  may  have  noticed  from  our  last  blog  post  "People  Looking 
at  Art  at  SFO  (1982  - 

2019)"  https : //millsf ield . sf omuseum. org/blog/2  019/02/26/p 

eopie/  we  are  in  the  thick  of  processing  the  back 

Catalog  https : / /millsf ield. sfomuseum.org/blog/ 2019/02/12/ 


iiif-aws/  of  installation  photos  for  all  the 

exhibitions  https : / /millsf ield. sfomuseum.org/exhibitions 
SFO  Museum  has  done  since  1980. 1  am  already  thinking  about  a 
second  "People  Taking  Pictures  of  Art  at  SFO"  blog  post  but  in 
the  meantime  we've  made  a  couple  additions  and  few  changes, 
improvements  hopefully,  to  the  Mills 

Field  https://millsfield.sfomuseum.org/  website  itself. 

First,  we've  created  a  dedicated  web  page  for  recently  processed 
images  https://millsfield.sfomuseum.org/images/recent 

By  default  we  sort  images  by  the  date  they  were 

taken  https://millsfield.sfomuseum.org/images/  ,  in 
descending  order,  to  more  closely  reflect  the  state  of  the  airport  and 
the  museum  "today" .  That  can  make  it  hard  to  see  images  that  have 
been  newly  processed  since  most  of  these  photos  were  taken  years 
ago.  Now  it's  possible  to  browse  those  images  in  the  order  that 
they've  been  added  https://github.com/sfomuseum- 
data/ sf  omuseum-data-media  to  the  Mills  Field  website. 

https://millsfield.sfomuseum.org/images/recent/ 

We  also  added  syndication  feeds  in  both  the 

Atom  https : / /millsf ield . sfomuseum.org/ images/ recent/ at 
om  and 

RSS  https : / /millsf ield . sfomuseum.org/ images/ recent/ rss 
formats  for  recently  digitized  images. 


•  •  • 


Smart  Feeds 
&  Today 
$  All  Unread 
lit  Starred 
On  My  Mac 


Installation  view  of 
"Japanese  Toys!  From  K... 
Feb  26,  2019 

Recently  digitized  images... 

Installation  view  of 
"Japanese  Toys!  From  K... 
Feb  26,  2019 

Recently  digitized  images... 

Installation  view  of 
"Japanese  Toys!  From  K... 
Feb  26,  2019 

Recently  digitized  images... 


So:  * 


1 


Recently  digitized  images  at  SFO  Museum 

Installation  view  of  "Japanese  Toys! 
From  Kokeshi  to  Kaiju" 

Feb  26,  2019  at  16:45 


Image  by  SFO  Museum.  It  was  taken  on  Nov  8,  2013. 


We  are  processing  images  in  batches  so  it's  not  unusual  for  there  to 
be  a  couple  hundred  new  images  to  look  at  all  at  once.  Rather  than 
publishing  a  syndication  feed  with  too  many  (all  the  new  images)  or 
too  few  (only  the  last  15  images)  things  we  split  the  difference. 

https  ://millsfield  .sfomuseum  .org/images/recent/ atom 
https://millsfield.sfomuseum.org/images/recent/rss 

Each  time  the  feed  is  requested  we  pull  the  200  most  recent  images 
and  return  25  of  them  randomly.  Assuming  your  feed  reader  is 
filtering  out  things  you've  already  seen  this  should  allow  for  a  steady, 
but  manageable,  stream  of  updates. 


►  mills  field  Q».  search  SFO  Museum  tJ 


/ 

Installation  view  of  "Airline  Identity:  Marks,  Brands  and  Logos" 


See  all  the  images  /  or  more  images  of  International  Terminal  or  AML  Aviation  Museum  Gallery  02 
or  Airline  Identity:  Marks,  Brands  and  Logos  or  San  Francisco  Airport  Commission  Aviation 
Library  and  Louis  A.  Turpen  Aviation  Museum  or  SFO  Terminal  Complex  or  San  Francisco 
International  Airport  /  or  just  view  a  random  image 

Image  by  SFO  Museum.  It  was  taken  on  Nov  25,  2013. 


Another  change  we've  made  is  an  update  to  the  header  and 
navigation  elements  on  the  Mills 

Field  https://millsfield.sfomuseum.org/  website. 
Specifically  we  have  begun  using  the  handy  HTML  details 
element  https :  / / developer  .mozilla .  org/en- 
US /docs /Web /HTML /Element /details  for  most  navigation  items. 
The  documentation  on  the  Mozilla  Developers 


Network  https : / / developer . mo z ilia . org/ en- 
US /docs /Web /HTML /Element /details  site  says  that: 


The  HTML  Details  Element  creates  a  disclosure 
widget  in  which  information  is  visible  only  when  the 
widget  is  toggled  into  an  "open"  state.  A  summary  or 
label  can  be  provided  using  the  summary  element. 


A  disclosure  widget  is  typically  presented  onscreen 
using  a  small  triangle  which  rotates  (or  twists)  to 
indicate  open/closed  status,  with  a  label  next  to  the 
triangle.  If  the  first  child  of  the  details  element  is 
a  summary,  the  contents  of  the  summary  element 
are  used  as  the  label  for  the  disclosure  widget. 


I  am  not  sure  when  the  details  element  was  first  introduced  but  I 
didn't  become  aware  of  it  until  I  saw  Mu- An  Chiou's 
presentation  https : //docs . google . com/ presentation/ d/ lhvnPp 
s Jo44BTPf Jx28CV95vqk_dt6nalawUbk0kmZYM/ edit#slide=id . p 

on  how  GitHub  is  using  it  so  thanks, 

GitHub  https://github.com/github/details-menu-element  ! 


[CAUTION 


mills  field 


search  SFO  Museum 


the  collection 
historical  maps 
our  weblog 
a  random  photo 
about  this  site 


search  SFO  Musei 


Installation  view  of  "Japanese  Toys!  From  Kokeshi  to  Kaiju" 


See  all  the  images  /  or  more  images  of  San  Francisco  International  Airport  or  SFO  Terminal  Complex 
or  Japanese  Toys!  From  Kokeshi  to  Kaiju  or  F-02  North  Connector  or  Terminal  3  or  Boarding  Area  F 
/  or  just  view  a  random  image 

Image  by  SFO  Museum.  It  was  taken  on  Nov  6,  2013. 


This  image  depicts 

San  Francisco  International  Airport  (an  airport)  and  SFO  Terminal  Complex 
(a  building)  and  Japanese  Toys!  From  Kokeshi  to  Kaiju  (an  exhibition)  and  F-02 
North  Connector  (a  gallery)  and  Terminal  3  (a  terminal)  and  Boarding  Area  F  (a 

boarding  area) 


Using  the  details  element  has  allowed  us  to  "tighten  up"  the 
header  which  works  better  across  a  range  of  device  sizes  and  is 
supported  natively  in  modem  web  browsers,  without  the  need  for 
JavaScript  to  render  collapsible  menus  on  tiny  mobile  screens. 


▼  mills  field 


the  collection 
historical  maps 
our  weblog 
a  random  photo 
about  this  site 


search  SFO  Museum 


Installation  view  of  "Down-Home  Music:  The 
Story  of  Arhoolie  Records" 


See  all  the  images  /  or  more  images  of  Terminal  2  or  San 
Francisco  International  Airport  or  SFO  Terminal  Complex  or 
D-12  Wall  Case  or  Down-Home  Music:  The  Story  of 
Arhoolie  Records  or  Boarding  Area  D  /  or  just  view  a 
random  image 


Image  by  SFO  Museum.  It  was  taken  on  Sep  18,  2018. 


We've  also  moved  image  titles  and  metadata  below  the  images 
themselves.  This  change  was  coupled  with  another  update  to  use 
HTML  picture  https : //developer . mozilla.org/en- 
US/docs/Web/HTML/Element/picture  element  now  that  we 

produce  multiple 


thumbnails  https  :  / /millsfield.  sfomuseum.org/blog/2019/ 02/ 
12/ iiif-aws/  for  every  image.  We  can  list  each  thumbnail  inside 
the  picture  element  and  more  accurately  tell  the  browser  which 
image  size  to  fetch  relative  to  a  device's  screen  size. 


iPhone  XR  C 


414  X  896  DPR:  2:  No  throttling  i 

►  mills  field  g 


Installation  view  of 
"Aviation  Evolutions:  The 
Jim  Lund  1 :72  Scale  Model 
Airplane  Collection" 

See  all  the  images  /  or  just  view  a 
random  image 


Image  by  SFO  Museum.  It  was  taken  on 

Oct  2,  2017. 


All  of  which  gets  a  little  closer  to  simple  and  elegant  pages  for 
images  where  image  itself  is  (almost)  always  "above  the  fold", 
meaning  you  don't  have  to  scroll  down  the  page  to  see  the  whole 
image. 


On  tiny  screens  this  sometimes  means  the  browser  will  choose  the 
smallest  available  image,  particularly  for  images  of  a  certain  aspect 
ratio.  As  a  consequence  it  can  be  difficult  to  see  the  details  in  some 
images  so  we've  included  links  to  all  the  different  sizes  "below  the 
fold"  and  we'll  add  the  ability  to  zoom  in  to  images  https :  //go- 
iiif  .  github .  io/go-iiif  /  Soon  enough. 


►  mills  field  gj 


Installation  view  of  "Caticons:  The  Cat  in  Art" 


See  all  the  images  /  or  more  images  of  A-02  International  South  Cases  or 
International  Terminal  or  San  Francisco  International  Airport  or  Caticons  or  SFO 
Terminal  Complex  or  International  Terminal  Main  Hall  /  or  just  view  a  random 
image 


Finally  the  random 

image  https://millsfield.sfomuseum.org/random  button  is 
still  there  in  the  header  but  has  been  replaced  by  the  @  symbol  in 
the  top  right-hand  corner. 


Ultimately,  this  may  not  be  the  best  way  to  signal  things  the  ability 
to  see  random  images  on  the  Mills  Field  website,  at  least  not  for  new 
visitors.  For  now  though  it  acts  as  a  place-holder  for  the  kind  of 
functionality  we  want  (a  discrete,  easy  and  consistent  way  to  find 


something  new  in  the  collection)  and  help  us  understand  how  that 
needs  to  work  relative  to  everything  else  on  the  site. 


2019-03-01 


things  I  have  written  about 
elsewhere  #201 90306 

The  @SFOMuseum  Twitter  Archive 


The  @SFOMuseum  Twitter 
Archive 


►  mills  field  Q*.  search  SFO  Museum  tJ 


@SFOMuseum  Twitter  Archive 

■ij  search  the  Twitter  arch 


Ann  Meade  created  these  ceramic  cats  featured  in  our  #ArtAndDisability 
exhibition.  #lnternationalCatDay 


This  tweet  was  posted  on  August  08,  2016. 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 
Weblog  https : //mills field . sf omuseum. or g /blog/ 20 19/03/06/ 
twitter  /  ,  in  March  2019. 

Earlier  this  year,  Darren  Milligan  http:  //darrenmiliigan . com  , 
Director  of  Smithsonian's  Learning 

Lab  https://learninglab.si.edu  ,  posted  the  following 
question  on 

Twitter  https : //twitter . com/DarrenMilligan/ status/ 1083012 
231720247296  : 


Trying  to  source  some  examples,  anecdotes,  or 
writing  on  how  museums  capture  non-institutional 
contextualization  of  digitized  collection  objects.  This 
might  include:  external  publishing  platforms,  social 
media  activity,  educational  uses.  ...  I  guess  the 
question  is,  is  anyone  capturing  any  of  this  activity? 


A  long  and  interesting 

Conversation  https : / /mobile . twitter . com/DarrenMilligan/ st 
at  us/ 1083012231720247296  ensued  and  at  one  point  I 
mentioned  https  :  /  / twitter  .  com/ thisisaaronland/ status/ 108 


3110414836150272 


...the  general-purpose  rule  of  archiving  activities  on 
third-party  sites  to  your  own  website 


SFO  Museum  makes  a  point  of  being  active  on  a  number  of  social 

media  https : / /WWW. f lysfo .com/museum/sfo-museum-social- 
media  platforms.  We  have  accounts  on 
Twitter  https://twitter.com/sfomuseum/  and 
Facebook  https://www.facebook.com/flySFO/  and 
Instagram  https://www.instagram.com/sfomuseum/  and  a  full¬ 
time  staff  member  -  Belinda  Li  -  whose  job  it  is  to  craft  and  curate 
posts  related  to  the  museum  and  its  collection  and  share  them  far  and 
wide  on  the  internet. 


It  is  important  to  recognize  that  Belinda's  work  is  not  simply  "non- 
institutional  contextualization  of  digitized  collection  objects"  but  an 
important  contribution,  one  that  is  central  to  the  museum's 
mission  https : / /www. flysfo.com/museum/about/mission- 
statement  .  Darren's  comments,  though,  served  to  highlight  the 
fact  that  we  haven't  done  a  great  job  of  "capturing"  or  "archiving" 
any  of  it. 


A  space  toy,  a  Jedi,  and  a  butterfly  walk  into  an  airport...  Happy  Halloween! 

#SneakPeak  #ToyStory20 

This  tweet  was  posted  on  October  30,  2015. 


Until  now!  It's  early  days  but  this  is  what  we've  done  so  far: 


•  We've  downloaded  an  archive  of  the  stuff  we've  posted 
on  each  of  the  social  networks  we  are  using  and  put 
them  in  a  safe  place  on  our  own  servers. 


We've  integrated  the  Twitter  archive  with  the  Mills 
Field 

website  https  :  //millsfield.  sfomuseum.org/twit 
ter/  giving  each  tweet  its  own  web  page  and  adding 
rudimentary  search  functionality. 

We've  started  to  link  individual  tweets  with  the 
exhibitions  they  mention;  eventually  we  will  do 
something  similar  for  other  aspects  of  the  museum 
collection. 

We  are  thinking  about  how  this  work  applies  to  our 
Facebook  and  Instragram  archives  and  we  are  thinking 
about  how  we  might  automate  some  or  all  of  these 
processes. 


►  mills  field  Q>.  search  SFO  Museum  S 

@SFOMuseum  Twitter  Archive 

■t)  search  the  Twitter  arch 


#BehindTheScenes  in  our  Design  Lab:  our  upcoming  exhibit  All  Roads  Lead 
to  Rome  is  taking  shape!  #AIIRoadsRome 


This  tweet  was  posted  on  January  12,  2017. 


By  way  of  example,  the  tweets  associated  with  the 
#BehindTheSceneS  https : //millsf ield . sfomuseum.org/ twitte 
r /search/ ?q=behindthescenes  and 


#SFOHistory  https : / /millsf ield. sfomuseum.org/twitter/ sea 
rch/?q=SFOHistory  hashtags  are  a  world  of  amazing 
wonderfulness  and  those  are  just  two  of 

many  https : / /millsfield. sfomuseum.org/twitter/ search/? 
q=avgeek  . 


►  mills  field  @ 

@SFOMuseum  Twitter  Archive 

search  the  Twitter  arch 


A  barbershop  opened  at  San  Francisco  International  Airport  in 
the  1970s.  At  the  opening  ceremony  airport  Director  William  J. 
Dwyer  received  a  haircut  from  barber  Joseph  Dias.  Do  you 
remember  this  barber  shop  at  #SFO?  #SFOHistory 


This  tweet  was  posted  on  October  04,  2018. 


Some  web  pages  for  individual  tweets  will  link  to  the  exhibitions 
they  mention.  This  is  not  the  case  for  all  tweets  yet  as  we've  just 
been  kicking  on  the  tires  on  how,  and  by  whom,  those  links  are 
made. 


►  mills  field  Q>.  search  SFO  Museum  @ 


@SFOMuseum  Twitter  Archive 

■t)  search  the  Twitter  arch 


As  cats  gained  popularity  as  pets  in  Europe  during  the  1600s,  they  appeared 
more  frequently  in  art  and  on  decorative  items.  Cat  motifs  are  among  the  many 
designs  applied  to  delftware  and  faience  pottery.  #Caticons 


This  tweet  was  posted  on  December  01, 2018. 

This  tweet  mentions  one  exhibition: 


Qatipong:  The  Cat  In  Art 

This  nonaviation  exhibition  is  on  display  between  July  20th  2018  and  April  22nd 
2019  in  the  A-02  International  South  Cases  gallery,  located  in  International 
Terminal  (International  Terminal  Main  Hall) 


Likewise,  all  exhibitions  now  have  an 

/ exhibitions/EXHIBITION-ID/twitter  page.  Here  are  all 
the  tweets  for  the  "Richard  Barnes:  Murmur"  photography 
exhibition  https : / /millsf ield. sfomuseum.org/exhibitions/13 
6 067 2 521 /twitter  ,  on  display  in  Terminal  3,  last  year: 


mills  field  Q,.  sea,ch  SFO  Museum  @ 

Tweets  about  Richard  Barnes:  Murmur 


55 (Hume  'Murmur*  by  IRIchardBames  on  display,  pre-security,  on  the 
departures  level  of  Terminal  3.  https://www.flysfo.com/museum 
/exhibitions/richard-barnes-murmur 


'Murmur'  by  rtfRIchardBarnes  on  display,  pre-security,  in  Terminal  3. 
https://www.flysfo.cam/musDum/exhibltions/richard-barnos-murmur 


In  his  series,  'Murmur',  artist  rtfRIchardBarnes  photographs  European 
starlings  as  they  coalesce  Into  dark  amorphous  shapes  that  dance  above 
Rome.  Barnes'  photographs  evoke  a  sense  of  mystery  in  the  seemingly 
choreographed  movements  of  the  migrating  birds. 


Every  winter,  hundreds  of  thousands  of  starlings  migrate  from  northern 
Europe  to  the  countryside  near  Rome  in  search  of  a  warmer  climate.  As 
dusk  falls,  the  birds  take  flight  in  dense  cloud-like  formations  known  as 
murmurations.  tfRichardBarnes 


Other  examples  include  the  Isamu  Noguchi:  Inside  and 
Out  https : / /mills field . sfomuseum.org/exhibitions/1226619 
8 15/twitter/  (23  tweets),  and  Celebrating  a  Vision:  Art  & 
Disabdlty  https : / /millsf ield. sfomuseum.org/exhibitions/ll 
5 9 16 0591 /twitter/  (96  tweets)  and  Fashion  in  Flight:  A  History 
of  Airline  Uniform 

Design  https : / /millsf ield . sfomuseum.org/ exhibitions /I 159 1 
6 012 9 /twitter/  (222  tweets)  exhibitions. 


Going  forward,  we  plan  to  do  the  same  for  all  the 

airplanes  https : //millsf ield . sfomuseum.org/ twitter/ search 

/?q=airplane  and 

airlines  https : / /millsf ield . sfomuseum.org/ twitter/ search/? 
q=airline  and 

airports  https : / /millsf ield . sfomuseum.org/ twitter/ search/ 
?q=airport  not  to  mention  individual  objects  in  our 
collection  https://millsfield.sfomuseum.org/collection 


https://millsfield.sfomuseum.org/twitter/search/?q=wine 
SFO  Museum 

Search  results  for  the  phrase  "wine"  in  the  @SFOMuseum  Twitter  archive 
There  are  4  results  for  this  query!  (290  kB)  ▼ 


So  that's  where  things  stand  today.  We  don't  model  or  publish  these 
tweets  (or  any  of  the  images  or  videos  associated  with  them)  using 
the  approaches  we've  developed  for  installation 

photos  https : / /millsf ield . sf omuseum. org/blog/2  019/02/12/i 
iif-aws/  or  Flickr 

photos  https : / /millsf ield . sf omuseum. org/blog/2  019/01/02/s 
urf  ace/  ,  at  least  not  yet.  It  seems  a  little  premature  as  we're  first 
trying  to  make  sure  that  we  can  fashion  the  different  data  exports 
from  the  different  providers  in  to  something  that  plays  well  with  the 
Mills  Field  https://millsfield.sfomuseum.org/  website.  Not 
all  data  exports  are  created  equally  but  that's  another  story  for 
another  day. 


https://millsfield.sfomuseum.org/twitter/ 

The  next  step  is  to  do  for  our  Facebook  posts,  and  then  Instagram 
photos,  what  we've  done  for  our 

tweets  https://millsfield.sfomuseum.org/twitter  .We'll 
post  updates  along  the  way  as  we  figure  out  how  best  not  just  to  keep 
Belinda's  work  safe  but  also  make  it  an  integral  part  of  the  Mills 
Field  https://millsfield.sfomuseum.org/  project  itself. 


Thanks, 

Darren  https : //twitter .com/DarrenMilligan/ status/1083012 
231720247296  ! 


@SFOMuseum  Twitter  Archive  <© 

■©  search  the  Twitter  arch 


NOW  PLAYING:  "Braiding  the  Sacred"  by  #MateoHinojosa.  Hinojosa  documents 
the  experiences  of  traditional  #corn  cultivators  from  several  #NativeAmerican 
communities  who  have  formed  an  alliance  in  their  struggle  for  #foodsovereignty. 
https://www.flysfo.com/museum/video-arts/braiding-sacred  #VideoArtsSFOM 

https://t.co/qkAwmsp8zZ 


2019-03-06 


view  source  for  emotional 

terroir 

ucd-username.wasm 


ucd-username.wasm 


I  learned  Go  https :  / / goiang . org  writing  go- 
ucd  https  :  / / github .  com/ aaronland/ go-ucd  which  is  nothing 
more  than  an  embedded  lookup  table  to  convert  Unicode 
characters  https://www.unicode.org/reports/tr44/  to  their 

English-language  Unicode 

name  https://www.unicode.org/reports/tr34/#uAX34-Ri 
For  example: 

$>  ./bin/ucd  % 

SOFT  ICE  CREAM 

Or: 


$>  ./bin/ucd 

NET;  WEB;  NETWORK,  NET  FOR  CATCHING  RABBIT 

Eventually,  I  wrote  go-ucd- 

USername  https :  / / github .  com/ aaronland/ go-ucd- 
username>go-ucd-username  on  top  of  go-UCd  to  allow  for 
meaningful  "pretty"  URL- safe  aliases  for  users  with  full  Unicode 
usernames.  For  example: 

. /bin/ucd-username  mr.  © 
mrgrinningf acewithsmilingeyes 

For  example,  a  user  with  the  name  Admiral  W  would  have  the 
pretty  URL  /  admiral  so  ft  icecream  rather  than  something  like 
/users/GSf  653874tgs  jBB7ZZqpO.  I  still  get  a  lot  of  blank 
stares  when  I  tell  people  about  go-ucd-username.  You  have  to 


believe  that  the  semantics  in  URLs  are 

important  https : / /WWW. aaronland. inf o/weblog/2 01 1/12 /02 /lo 
oking/#anti-aiiasing  and  if  you  don't  then  I  agree  the  whole 
thing  is  a  bit  silly. 

While  it's  true  that  an  Internalized  Resource 

Identifier  https : / /www . w3 . org/ International/ articles/ idn- 
and-iri/  (IRI)  would  allow  you  to  create  an  equivalent 
/ Admiral  %  2  0  URL  it's  still  early  days  for  IRIs  meaning 

browser  support  is  uneven  and  there  are  a  number  of  security 
concerns  https://www.unicode.org/reports/tr36/  that 
haven't  been  fully  sorted  yet. 


The  alternative  is  to  strip  out  all  the  non-URL  safe  characters  from 
URLs  which  means  if  you  have  one  user  with  the  name  Bob  and 
another  with  the  name  Bob  V  and  another  still  with  the  name  Of 
Bob  only  one  of  them  can  have  the  pretty  URL  /bob. 

go-ucd-username  side-steps  all  those  issues  and  allows  for  a 
better-than-nothing  alternative.  I  make  a  point  of  using  go-ucd- 
username  on  any  website  I  run  with  user  accounts.  I  don't  expect 
many  people  either  know  about  it  or  benefit  much  from  what  it  does 
but  I  like  the  idea  of  accounting  for  tiny  (but  important)  details  like 
this. 


There  is  nothing  specific  to  the  Go  programming  language  about 
go-ucd-username.  Go  is  very  fast,  has  excellent  Unicode 
support  and  allows  you  to  create  pre-compiled  binaries  for  a  number 
of  operating  systems  so  you  can  write  tools  that  don't  first  require 
installing  a  bunch  of  other  things  in  order  to  start  using  them. 
Beyond  that  go-ucd-username  could  be  written  in  any  modern 
programming  language. 


In  the  time  since  it  was  first  written  we've  seen  the  introduction  of 
WebAssembly  https  :  / / developer  .mozilla .  org/en- 
us/docs/webAssembiy  which  the  Mozilla  Developer  Network 
describes  as  "...a  way  to  run  code  written  in  multiple  languages  on 
the  web  at  near  native  speed,  with  client  apps  running  on  the  web". 
One  of  those  languages  is 

Go  https://golang.org/pkg/syscall/js/  and  the  Other  day  I 
wondered  whether  go-ucd-username  would  be  a  good  way  to 
kick  the  tires  and  see  how  it  all 

Works  https://aaronland.github.io/go-ucd-username/ 


UCD  |^jy 

•A  Cf  tal  ©  localhost:8080  •••  ©  &  Q.  Search 

±  m\  ei  a  J1  o  s  e 

UCD  Username  converter 

captain  &  S3 

Convert 

UCD  username  is 

captainclosedmailboxwithloweredf lages sent ialoilof butter 

C£3  O  Inspector 

m  Console  D  Debugger  { }  Style  Editor  @  Performance  O  Memory  ]f  Network 

§  Storage  Accessibility  »  Q]  •••  X 

®  Filter  output 

—  Persist  Logs 

2019/03/15  10 

35:35  RUNE  8:26  U+0044  'D' 

wasm_exec. js:47:6 

2019/03/15  10 

35:35  RUNE  8:27  U+0020  1  ' 

wasm_exec . j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  8:28  U+0046  'F' 

wasm_exec . j  s : 47 : 6 

2019/03/15  10 

35:35  RUNE  8:29  U+004C  ' L ' 

wasm_exec. js:47:6 

2019/03/15  10 

35:35  RUNE  8:30  U+0041  'A' 

wasm_exec . j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  8:31  U+0047  ’G' 

wasm_exec . j  s : 47 : 6 

2019/03/15  10 

35:35  RUNE  12  U+0020  '  ' 

wasm_exec. js:47:6 

2019/03/15  10 

35:35  RUNE  12  U+0020  '  1  is  space  SKIPPING 

wasm_exec . j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  13  U+0026 

wasm_exec . j  s : 47 : 6 

2019/03/15  10 

35:35  RUNE  13  U+0026  '&'  is  punctuation  SKIPPING 

wasm_exec. js:47:6 

2019/03/15  10 

35:35  RUNE  14  U+0020  ‘  ' 

wasm_exec. j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  14  U+0020  '  '  is  space  SKIPPING 

wasm_exec . j  s : 47 : 6 

2019/03/15  10 

35:35  RUNE  15  U+918D  'S' 

wasm_exec. js:47:6 

2019/03/15  10 

35:35  RUNE  15  U+918D  'Si'  is  not  whitelisted  PROCESSING 

wasm_exec . j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  15  U+918D  'S'  return  string  'ESSENTIAL  OIL  OF  BUTTER'  PROCESSING 

wasm_exec . j  s : 47 : 6 

2019/03/15  10 

35:35  RUNE  15:0  U+0045  ' E ' 

wasm_exec. j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  15:1  U+0053  'S' 

wasm_exec . j s : 47 : 6 

2019/03/15  10 

35:35  RUNE  15:2  U+0053  'S' 

wasm_exec . j  s : 47 : 6 

» 

Is  it  possible  to  call  the  ucd-username 

functionality  https :  / / github .  com/ aaronland/ go-ucd- 
username/blob/master/cmd/ucd-wasm. go  written  in  Go  from 
JavaScript  https : / / github . com/ aaronland/ go-ucd- 
username/blob/master/www/ index .  html  ?  Yes.  Is  it  worth 
downloading  and  executing  a  6.3MB  binary  to  do  what  could 
probably  be  done  in  ~  1 00  lines  of  native  JavaScript?  Probably  not. 
There  are  better 

things  https : / /blog . gopheracademy . com/ advent-2  018/ go-in- 
the-browser/  to  use  WebAssembly  for  if  only  because  the  setup 


and 

Scaffolding  https : / / github . com/ golang/ go/wiki/WebAssembl 
y  required  to  do  anything  with  it  is  a  bit  of  a  twisty  maze. 

For  example  I  spent  the  better  part  of  45  minutes  trying  to  embed  the 
exact  same  code  that  works  just  fine  over 

here  https://aaronland.github.io/go-ucd-username/  on  this 
website  but  with  no  success: 

https://aaronland.github.io/go-ucd-us 
ername/  https  ://aaronland.githu 
b. io/go-ucd-username/ 


I  have  no  idea  why  it  doesn't  work  because  there's  very  little  in  the 
way  of  debugging  and  it  fails  with  a  different  set  of  error  conditions 
in  Firefox  than  it  does  in  Safari.  But  only  on  this  website... 

So,  it's  clearly  all  still  "wet  paint"  but  it's  good  to  get  a  feel  for 
what's  possible  https  :  /  / github .  com/ aaronland/ go-ucd- 


username#wasm 


2019-03-16 


generative  adversarial 
networks  for  signs  and 

signifiers 

Mr.  Big  Balls 


Mr.  Big  Balls 


"Mr.  Big  Balls "  as  we  came  to  know  him  hasn't  been  around  the 
neighbourhood  in  a  while.  I  have  been  thinking  about  him  lately  and 
hope  he  is  well  wherever  his  travels  have  taken  him. 


2019-03-19 


phase-shifting  for  fun  and 

profit 

Mapping  Space,  Time,  and  the  Collection  at  SFO... 


Mapping  Space,  Time,  and 
the  Collection  at  SFO 
Museum 


Figure  1:  Photograph  of  a  geolocated  device,  in  the  International  Terminal  Main  Hall  (c.  2018),  facing  the  Caticons: 
The  Cat  in  Art  exhibition,  with  a  1943  aerial  photo  of  the  SFO  campus. 


This  paper  was  originally  published  on  the  Muse  Web  2019 
conference  https : / /mwl9 .mwconf .org/paper/mapping-space- 
time-and-the-collection-at-sf  o-museum/  website. 


The  SFO  Museum  https://sfomuseum.org/  is  a  fully 
accredited  museum  that  has  operated  inside  and  as  part  of  the  San 
Francisco  International  Airport  https :  /  /f  lysf o .  com/  (SFO) 

since  1980.  The  airport  is  owned  and  operated  by  the  City  and 
County  of  San  Francisco  https://sfgov.org/  .  SFO  Museum 
consists  of  a  permanent  aviation  collection,  with  a  focus  on  “the 
history  of  commercial  air  transport,  the  airline  industry,  and  San 
Francisco  International  Airport  with  a  regional  emphasis  on  the  West 
Coast  and  the  Pacific  Rim,”  an  aviation  library  and  archive.  There  is 
also  as  an  active  program  of  curated  temporary  exhibitions  (on 
average  30-40  annually)  consisting  of  a  mix  of  objects  from  the 
permanent  collection  and  loan  objects  from  private  lenders  and  other 
cultural  heritage  institutions.  Additionally,  SFO  Museum  oversees 
the  public  art  works,  purchased  by  the  San  Francisco  Arts 
Commission  (SFAC),  on  display  at  the  airport.  In  2017,  55  million 
passengers  flew  in  or  out  of  SFO. 


A  museum,  with  both  temporary  and  permanent  collections,  is 
distinct  from  a  library  as  both  are  from  an  archive.  Each  represents  a 


unique  areas  of  focus,  expertise,  and  responsibility,  and  they  carry 
important  and  meaningful  distinctions  to  people  who  work  in  the 
cultural  heritage  sector.  The  same  can’t  be  said,  or  assumed,  of 
people  not  working  in  the  cultural  heritage  sector  so  for  the  purposes 
of  this  paper,  when  I  discuss  “the  collection,”  I  am  talking  about 
everything  that  SFO  Museum  does,  everything  it  produces, 
everything  it  cares  for. 


SFO  Terminal  Complex  (201 7~) 

This  building  supersedes  SFO  Terminal  Complex  (2014~  -  2017~) 


Terminals  Boarding  Areas  Galleries  Exhibitions  Public  Art 


Here  are  three  random  images  of  SFO  Terminal  Complex 

There  are  251  images  of  this  building  /  or  just  jump  to  random  image 


Installation  view  of  "Maneki 
Neko:  Japan's  Beckoning  Cat" 


Installation  view  of  "Aviation 
Evolutions:  The  Jim  Lund  1:72 
Scale  Model  Airplane  Collection" 


Installation  view  of  "Aviation 
Evolutions:  The  Jim  Lund  1 :72 
Scale  Model  Airplane  Collection' 


Image  by  SFO  Museum.  It  was 
taken  on  Feb  7,  2018 


Image  by  SFO  Museum.  It  was 
taken  on  Oct  2,  2017 


Image  by  SFO  Museum.  It  was 
taken  on  Oct  2,  2017. 


Figure  2:  Screenshot  of  the  SFO  Museum  Web  page  for  the  SFO  Terminal  Complex. 


Starting  in  early  2018,  SFO  Museum  secured  funding  for  full-time 
staff  to  pursue  digital  initiatives  around  the  museum’s  collection 
and  exhibitions 

history  https://millsfield.sfomuseum.org/about  .  This  paper 
documents  those  efforts  to  date.  The  goal  of  this  work  can  be 
summarized  as  follows: 


To  ensure  that  every  aspect  of  a  trip  to  SFO,  and  every  facet  of 
someone’s  time  spent  in  the  airport  whether  they  are  arriving  in  San 
Francisco  or  departing,  leads  back  to  the  museum’s  collection. 


Further,  we  want  to  ensure  that  the  museum  "follows  you"  beyond 
the  airport.  One  could  imagine  a  visitor’s  mobile  device  following 
them  through  the  airport,  and  deliberately  or  passively,  collecting 
objects  on  display  in  the  terminals  or  entire  exhibitions  or  facets  of 
the  airport  itself.  That  same  device  could  then  request  and  receive 
related  materials  from  the  collection  that  could  be  viewed  at  a 
departure  gate  or  even  offline  while  sitting  on  an  airplane  in  flight. 
That  same  infrastructure  could  also  be  used  to  deliver  materials  to 
passengers  in  advance  of  their  arrival  at  SFO,  whether  it  is  through 
the  museum’s  own  online  efforts  or  third-party  initiatives  like  back- 
of-seat  entertainment  systems  on  airplanes. 


F-02  North  Connector  (201 4~  -  201 7~) 

This  gallery  was  in  Boarding  Area  F,  which  is  located  in  Terminal  3  /  see  all  the  galleries 

This  gallery  supersedes  F-02  North  Connector  (2011~  -  201 4~)  and  is  also  superseded  by  F-02  North  Connector  (201 7~) 


Here  are  three  random  images  of  F-02  North  Connector 

There  are  312  images  of  this  gallery  /  or  just  jump  to  random  image 


Installation  view  of  "Games  of 
Chance:  Gambling  Devices  of  the 
Mechanical  Age" 


Installation  view  of  "Life  and 
Style  in  the  Age  of  Art  Deco" 


Installation  view  of  "Games  of 
Chance:  Gambling  Devices  of  the 
Mechanical  Age" 


Image  by  SFO  Museum.  It  was 
taken  on  Dec  21,  2016. 


Image  by  SFO  Museum.  It  was 
taken  on  Jul  20,  2015. 


Image  by  SFO  Museum.  It  was 
taken  on  Feb  2,  2017 


Figure  3:  Screenshot  of  the  SFO  Museum  Web  page  for  the  F-02  North  Connector  gallery  space  in  Terminal  3  (c.  2014- 

17). 


The  lovely  thing  about  a  museum  like  our  is  that  the  visitors,  and  all 
the  places  they  travel  to  and  from,  as  well  as  the  airplanes  and 
airlines  that  are  taking  them  there,  are  the  glue  that  connects  the 
museum’s  different  efforts.  Place  and  travel  connect  them  since 
every  thing  is  from  some  place  and  people— the  passengers  (visitors) 
passing  through  the  airport— are  what  connect  travel  and  place. 

That  is  why  SFO  Museum  has  focused  its  initial  digital  efforts  at  the 
macro  level,  starting  with  maps  of  the 

World  https : //mil Is field . sfomuseum.org/blog/ 2018/07/31/ 
maps/  and  the  infrastructure  to  sustain  them,  moving  closer  and 
closer  to  the  micro  level,  the  objects  in  our  collection,  working  to 
model  the  airport’s 

architecture  https : / /millsfield. sfomuseum.org/blog/2018/ 08 
/ 2 8/whosonf  irst/  (from  buildings  down  to  individual  galleries) 
as  well  as  the  museum's  exhibition 

history  https : / /millsfield. sfomuseum.org/blog/2018/10/17/ 
exhibitions/  along  the  way. 

Who’s  On  First 

Our  work  extends  the  Who’s  On 

First  https://www.whosonfirst.org/  (WOF)  project,  an  openly 
licensed  gazetteer  with  both  global  and  historical  coverage,  to 
support  indoor  locations  as  well  as  objects,  exhibitions,  airlines  and 
aircraft  all  situated  in  an  explicit  geographic  context. 


WOF  describes  itself  https://www.whosonfirst.org/what/  as 


•  [A]n  openly  licensed  data  set.  At  its  most  restrictive, 
data  is  published  under  the  Linux  Foundation ’s 

Community  Data  License 

Agreement  https://cdia.io  (CDLA)l.O. 

•  Every  record  in  Who  \ 's  On  First  has  a  stable  permanent 
and  unique  numeric  identifier.  There  are  no  semantics 
encoded  in  the  IDs. 

•  At  rest,  each  record  is  stored  as  a  plain-text 
GeoJSON  https : / / tools . ietf . org/html/rf c7  94  6 
file.  Our  goal  is  to  ensure  that  Who’s  On  First  embodies 
the  principals  of  portability,  durability  and  longevity. 
This  led  us  to  adopt  plain-vanilla  text  files  as  the  base 
unit  of  delivery. 

•  Files  are  stored  in  a  nested  hierarchy  of  directories 
derived  from  their  IDs. 

•  There  are  a  common  set  of  properties  applied  to  all 
records  which  may  be  supplemented  by  an  arbitrary 
number  of  additional  properties  specific  to  that  place. 


There  are  a  finite  number  of  place  types  in  Who’s  On 
First  and  all  records  share  a  common  set  of  ancestors. 
As  with  properties,  any  given  record  may  have  as 
complex  a  hierarchy  as  the  circumstances  demand,  but 
there  is  a  shared  baseline  hierarchy  across  the  entire 
data  set. 

Individual  records  may  have  multiple  geometries  or 
multiple  hierarchies  and  sometimes  both. 

Records  may  be  updated  or  superseded,  cessated,  or 
even  deprecated.  Once  a  record  is  created  though  it  can 
never  be  removed  or  replaced. 

Lastly  and  most  importantly,  Who ’s  On  First  is  meant, 
by  design,  to  accommodate  "all  of  the  places." 

Who  ’.v  On  First  is  not  a  carefully  selected  list  of 
important  or  relevant  places.  It  is  not  meant  to  act  as 
the  threshold  by  which  places  are  measured.  Who ’s  On 
First,  instead,  is  meant  to  provide  the  raw  material  with 
which  a  multiplicity  of  thresholds  might  be  created. 
From  the  Who’s  On  First’s  perspective,  the  point  is  not 
that  one  place  is  more  important  or  relevant  than  any 
other.  The  point  is  not  that  a  place  may  or  may  not  exist 
anymore  or  that  its  legitimacy  as  a  place  is  disputed. 


The  point  is,  critically,  that  people  believe  them  to  exist 
or  to  have  existed. 


Fundamentally  all  museum  collections  are  situated  in  space  and 
time,  if  only  as  a  reflection  of  the  need  for  accurate  inventory, 
tracking  between  storage  and  display  areas.  By  extension,  all 
museum  collections  and  collections  management  systems  are 
inherently  spatial-temporal  databases. 

Location  and  history,  though,  are  also  core  to  the  experience  of  the 
objects  themselves  and  in  many  cases  the  lenders  or  lending 
institutions.  Knowing  the  time  and  location  of  an  object  in  the 
museum  could  easily  be  extended  to  track  the  time  and  location  of  an 
object  both  before  it  is  accessioned  in  to  a  collection  as  well  as 
afterwards  when  it  is  de-accessioned.  As  often  as  not,  the  place  an 
object  is  "from"  originally  is  no  longer  the  same  place,  politically  or 
culturally,  by  the  time  it  is  viewed.  All  of  these  dynamics  are 
emphasized  in  an  airport  museum  where  people  are  traveling  to  (or 
arriving  from)  those  same  places  that  the  objects  on  display  are  from 
or  depict. 

Although  many  collections  management  systems  have  some  notion 
of  geography,  or  place,  typically  location  support  beyond  the 
warehouse  is  average  to  poor.  Location  information,  when  it  exists,  if 
often  scoped  to  nothing  more  precise  than  a  country  or  a  locality  and 
limited  to  point-based  geometries.  When  an  organization  or 


consortium  has  created  a  gazetteer  with  more  detailed  information, 
those  projects  have  typically  been  bound  to  a  specific  historical 
period  or  been  geographically  regional  in  focus. 
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Figure  4:  Screenshot  of  contemporary  and  historical  geometries  for  buildings  on  the  SFO  campus  ( August ,  2018). 


For  many  years,  the  gazetteer  of  record  in  the  cultural  heritage  sector 
has  been  the  Getty  Institute’s  Thesaurus  of  Geographic 

Names  https  :  /  / www .  getty .  edu/ research/ tools  / vocabular ie 
s/tgn/  (TGN),  first  published  in  1997.  TGN  adopts  (and 
influenced)  many  of  the  same  principals  of  the  WOF  project: 
Machine-readable  documents,  stable  and  permanent  identifiers,  a 
hierarchical  structure  of  pointers  to  related  documents  and  a  rich  set 
of  metadata  properties  describing  that  place.  Until  2014,  TGN 
remained  a  licensed  and  proprietary  data  set  placing  it  outside  the 
reach  of  many  institutions  and  the  awareness  of  those  outside  the 
cultural  heritage  sector.  In  2014,  TGN  was  made  publicly  available 
as  part  of  Getty’s  larger  Linked  Open  Data 

program  https : / /WWW. getty . edu/ research/ tools/ vocabular ie 
s / lod/ index .  html  ,  released  under  the  Open  Data  Commons 
Attribution 

License  https : / / opendatacommons . org/licenses/by/ index . h 
tmi  (ODB-By). 


This  was  an  unqualified  good  thing  and  an  example  for  the  rest  of  the 
cultural  heritage  sector  to  follow.  Unfortunately,  the  manner  is  which 
the  data  is  published  remains  problematic.  A  detailed  critique  of 
TGN's  approach  (a  single  17  gigabyte  machine-readable  but 
ultimately  human- unfriendly  file)  is  outside  the  scope  of  this  paper 
but  the  consequence  of  TGN’s  decisions  is  that  the  data  is  rendered, 
if  not  unusable,  then  beyond  the  technical  and  infrastructure-related 
means  of  many  who  might  use  it. 


SFO  Museum  has  chosen  instead  to  adopt  the  Who’s  On  First 
(WOF)  gazetteer  for  the  following  reasons: 


•  The  scale  and  breadth  of  the  project.  In  2019,  the  core 

administrative  data 

set  https : / /github.com/whosonf irst- 
data/whosonf  irst-data  for  WOF  consists  of  4.8 
million  places  from  continents  to  neighborhoods, 
spanning  the  entire  planet.  It  is  actively  maintained  and 
updated  and  has  detailed  polygons  (geometries)  for 
most  features. 

•  Use  of  the  Geo  J SON  format, now  formalized  as  the 
Internet  Engineering  Task  Force’s  RFC  7946,  which  is  a 
simple  text-based  format  for  describing  geometries  and 
properties  with  broad  support  in  both  open-source 
community  and  proprietary  geographical  information 
systems  software,  ranging  from  web-based  mapping 
tools  to  sophisticated  desktop  applications  to  server- 
side  spatial-processing .  (Fun  fact:  Sean 

Gillies  https :  // sgiilies  .net/  one  of  the  original 
authors  of  the  GeoJ SON  specification  was  also  the  lead 
engineer  on  the  Pleiades 

gazetteer  https://pieiades.stoa.org/  of  ancient 
places  project. 


WOF’s  dictum  that  “the  data  is  not  the  database,” 
meaning  the  project  aims  to  be  usable  with  any  and  all 
databases,  rather  than  tailored  to  the  specifics  of  any 
one  tool. 

Concordances  are  pointers  from  WOF  identifiers  to 
other  gazetteers  like  TGN  or  Geonames.  This  ensures 
greater  portability  should  SFO  Museum  decide  to 
migrate  its  services  to  another  gazetteer  or  geo¬ 
infrastructure. 

Use  of  the  Library  of  Congress’  Extended  DateTime 
Format  https : //WWW. loc . gov/ standards /datetim 
e/  (EDTF)  a  robust  syntax  for  describing  uncertain  or 
ambiguous  dates  (and  set  to  become  part  of  the  ISO 
8601  date  format  in  late  2019). 

The  ability  to  define  multiple,  distinct  instances  of  the 
same  place  as  a  kind  of  historical  "linked-list." 
Wikipedia  defines  a  linked- 

list  https : / /en. wikipedia.org/wiki/Linked_list 
as  a  "linear  collection  of  data  elements  [where]  .  .  . 
each  element  points  to  the  next. "  It  is  a  data  structure 
consisting  of  a  collection  of  nodes  which  together 
represent  a  sequence.”  For  example,  the  context  in 
which  the  Olympic  Stadium  in  Sarajevo  in  1988  existed 
was  a  quantifiably  different  place  than  the  same 


geographic  location  in  1993  or  again  in  2018.  The  same 
could  be  said  of  Berlin  during  the  Weimar  Republic 
versus  the  Berlin  of  the  Cold  War  or  more  recently 
Berlin  in  the  years  following  German  reunification.  The 
list  is  as  long  as  there  are  places  in  the  world.  In  all  of 
these  examples,  these  are  the  same  place 
geographically  but  their  cultural  and  political  context  is 
dramatically  and  meaningfully  different.  WOF  assigns 
each  context  a  unique  identifier  and  then  links  them 
together  through  the  use  of  " supersedes "  and 
" superseded  by" pointers. 

The  ease  with  which  the  WOF  data  model  can  be 
extended  to  suit  the  needs  of  a  project  like  SFO 
Museum.  The  SFO  Museum  digital  initiatives  demanded 
that  the  museum  model  the  history  and  the  evolution  of 
the  airport  itself,  creating  stable  and  permanent  geo- 
referenced  records  for  all  the  relevant  architectural 
elements,  including  the  airport  complex  itself, 
terminals,  boarding  areas,  and  galleries.  This  meant 
extending  the  existing  hierarchy  of  administrative  place 
types  in  WOF  to  support  modeling  for  indoor  spaces. 

Familiarity.  This  author  has  been  involved  with  WOF 
project  since  its 

inception  https:  / /whosonfirst .  org/blog/2  015/0  8  / 
18/who-s-on-f  irst/  ,  working  full-time  on  the 


project  between  2015- 

2017  https : / /whosonf irst.org/blog/2018/ 01/02 /c 
hapter-two/  . 


Extending  Who’s  On  First 


Figure  5:  Screenshot  of  early  work  to  describe  interior  place  types  following  the  Who  ’5  On  First  project's  hierarchical 

model. 


A  central  tenet  of  the  WOF  project  is  that  the  core  set  of  place  type 
descriptors  https : // github . com/whosonf irst/whosonf irst- 
piacetypes  be  as  few  and  as  broad  in  scope  as  possible.  Each 
WOF  place  type  is  assigned  one  of  three  possible  roles:  Common, 
Common-Optimal,  and  Optimal.  Common  place  types  are: 
"Continent,''  "Country,"  "Region,"  "Locality,"  and  "Neighborhood." 

Place  types  are  used  to  define  the  hierarchy  (of  ancestors)  for  a  place 
and  while  any  record  may  have  as  complex  a  hierarchy  as  necessary, 
one  of  the  few  absolute  rules  in  WOF  is  that  every  hierarchy  contain 
at  least  one  of  the  common  place  types.  The  rationale  for  a  common 
set  of  place  types,  across  the  entire  data  set,  is  to  ensure  that  two  or 
more  independent  projects  can  establish  a  geographic  concordance, 
with  global  coverage,  requiring  only  minimal  technology  and 
infrastructure  costs. 


The  ability  to  describe  common  place  types  for  the  entire  planet 
requiring  only  five  database  columns  is  understood  to  be  a 
reasonable  middle-ground  given  the  complexity  and  nuance  of  place 
multiplied  by  the  scale  of  the  planet.  By  standardizing  on  the 
common  place  types,  it  ensures  that  diverse  projects  can  talk  about 
(common)  places  and  do  so  with  the  confidence  that  they  are  talking 
about  the  same  thing  and,  most  importantly,  the  same  thing  at  a 
specific  moment  in  time. 


If  a  project  needs  or  wants  to  capture  more  detail  about  a  place,  for 
example  referencing  the  borough  of  Brooklyn  in  New  York  City, 
then  they  will  need  to  add  a  “sixth”  database  column.  There  is  no 
guarantee  that  another  project  will  also  do  the  same  but  at  least 
everyone’s  efforts  can  intersect  at  a  common  understanding  of  New 
York  City  (locality)  and  any  of  its  ancestors. 

There  is  not  a  dedicated  place  type  for  airports  in  WOF.  Rather  an 
airport  is  said  to  be  a  (common-optional)  “campus”  because  it  is 
more  similar  in  nature  to  other  campuses  than  not:  A  university 
campus,  a  medical  complex  or  an  office  complex.  WOF  assumes  that 
the  specificity  of  a  place  can  and  will  be  encoded  in  name-spaced 
properties  unique  to  that  record.  For  example  the  abbreviated  WOF 
record  for  the  San  Francisco  International 
Airport  https : / / spelunker . whosonf irst . org/ id/ 10252  75 13 

(SFO)  is: 


"properties":  { 

" oa : type " :  " lar ge_airport " , 

" sf omuseum: placetype" :  "airport" , 

"wof : id" :  102527513, 

"wof : name" : "  San  Francisco  International  Airport", 

"wof : placetype" :  "campus" 

> 

At  the  beginning  of  2018,  the  smallest,  most  atomic,  place  type  in 
WOF  was  the  "venue."  Venues  are  typically,  but  not  exclusively, 
parented  by  the  "building"  place  type.  Like  a  "campus"  the  meaning 
of  the  "venue"  place  type  is  deliberately  fluid  and  considered  to  be 
“any  space  around  which  people  might  gather.”  A  venue  might  be  a 


shop  or  a  performing  arts  center  or  a  public  landmark.  While  SFO 
Museum’s  public  art  works  had  previously  been  classified  as 
“venues”  by  the  WOF  project,  in  2016,  this  place  type  was 
determined  to  be  insufficient  for  the  overall  needs  of  SFO  Museum. 
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Figure  6:  Screenshot  of  contemporary  and  historical  geometries  for  buildings  on  the  SFO  campus  (Oct.  2018). 


SFO  Museum  proposed  five  additional  optional  place  types.  Three  of 
them  are  said  to  be  ancestors  of  venues  while  the  other  two  are 
descendants.  They  represent  common  indoor  architectural  place 
types  that  might  be  applied  to  other  building  spaces  and  whose 
semantics  are  meant  to  flexible  enough  to  accommodate  a  range  of 
use-cases.  They  are: 


place  type 

description 

wing 

A  principal  subdivision  inside  of  a  building. 

concourse 

A  secondary  subdivision  inside  of  a  building 
(wing). 

arcade 

An  arcade  is  any  deliberate  or  de-facto 
space  inside  a  concourse. 

enclosure 

An  enclosure  is  any  deliberate  space  inside  a 

venue. 

installation 

Any  fixed  element  (permanent  or  semi¬ 
permanent)  that  is  not  an  enclosure. 

The  machine-readable  definition  for  an  " enclosure"  consists  of  a 
unique  numeric  ID,  a  name  label,  a  role  and  an  ordered  list  of 
possible  ancestors  (other  place  types): 


"wof : id" :  1159268867, 

"wof: name":  "enclosure", 

"wof: role":  "optional", 

"wof : parent " :  [  "venue",  "arcade",  "concourse"  ] 


Although  SFO  Museum  architectural  records  adopt  these  generic 
WOF  place  types  their  labels  are  not  suitable  for  display  purposes. 


SFO  Museum  supplements  these  new  (WOF)  place  types  with  its 
own  "sfmuseurmplacetype"  property,  as  follows: 


Who’s  On  First  place  type  SFO  Museum  place  type 


wing 

concourse 

arcade 

enclosure 

installation 


terminal 

boardingarea  Or  commonarea 

observationdeck 

gallery 

exhibition 


For  example,  the  abbreviated  WOF  record  for  the  D-12  Wall 
Gallery  https  :  / /millsf  ield .  sfomuseum.org/ galleries  / 1 15  9 
157067/  in  Boarding  Area 

D  https : / /millsf ield . sfomuseum.org/boardingareas/11593 

96181/  ,  Terminal 

2  https : / /mills field. sfomuseum.org/terminals/1159396121 

/  ,  is: 


properties":  { 

" sf omuseum: placetype" :  "gallery" , 
"wof :id" :  1159157067, 

"wof : name" :  "D-12  Wall  Case", 

"wof : parent_id" :  1159396181, 

"wof : hierarchy " :  [ 

{ 

"building_id" :1159157271, 
"campus_id" : 102527513, 
"concourse_id" :1159396181, 
"continent_id" : 102191575, 

" country_id " :85633793, 

" county_id " :102087579, 
"enclosure_id" : 1159157067, 

" local ity_id" : 85922583, 

" neighbourhood_id " : - 1 , 
"region_id" : 85688637, 
"wing_id" : 1159396121 


} 

] , 

"wof : placetype " :  "enclosure" 

} 

WOF  metadata  properties  are  encoded  using  the  GeoJSON  format’s 
"properties"  dictionary,  which  is  an  arbitrary  set  of  key-value  pairs, 
where  each  value  may  be  any  valid  GeoJSON  data  type  (string, 
integer,  dictionary,  etc.).  WOF  properties  are  enforced  through 
convention,  and  in  some  instances,  code  when  processing  data  using 
a  strictly- typed  programming  language,  rather  than  a  formal  schema. 

There  are  ongoing  efforts  to  define  a  JSON  Schema  for  validation 

purposes  https: / /whosonfirst .org/blog/2018/05/25/three- 
steps -backwards/  but  in  general,  the  imperfect  nature  of 
geographic  metadata  and  its  uneven  coverage  at  a  global  scale 
demand  the  flexibility  of  an  open-ended  dictionary.  This  also  allows 
a  project  like  SFO  Museum’s  to  quickly  and  easily  define  its  own 
properties  typically  through  the  use  custom  namespaces  (for 
example,  "sfomuseum:"  or  "flysfo:). 


Installation  view  of  "Celebrating  a  Vision:  Art  & 
Disability" 


See  all  the  images  /  or  more  images  of  Boarding  Area  F  or  San  Francisco  International  Airport  or  F-02  North  Connector  or  SFO 
Terminal  Complex  or  Terminal  3  or  Celebrating  a  Vision :  Art  &  Disability  /  or  just  view  a  random  image 


Image  by  SFO  Museum.  It  was  taken  on  Apr  1 , 201 6. 


This  image  depicts 

Boarding  Area  F  (a  boarding  area)  and  San  Francisco  International  Airport  (an 
airport)  and  F-02  North  Connector  (a  gallery)  and  SFO  Terminal  Complex  (a 
building)  and  Terminal  3  (a  terminal)  and  Celebrating  a  Vision:  Art  &  Disability  (an 

exhibition) 


Figure  7:  Screenshot  of  the  SFO  Museum  Web  page  for  an  installation  photo  from  the  Celebrating  a  Vision:  Art  & 

Disability  exhibition. 


WOF’s  flexible  approach  to  modeling  data  has  allowed  SFO 
Museum  to  associate  and  contextualize  the  1 ,300+  exhibitions 
produced  during  the  museum’s  38  year 

history  https : / /mills field . sfomuseum.org/exhibitions / yea 
rs/  across  50  gallery 

spaces  https://millsfield.sfomuseum.org/galleries/  in 

addition  to  the  the  museum’s  aviation  collection  with  the  airport  as  it 
existed  at  the  time  of  an  exhibition  or  when  an  artifact  was  created. 


Imagery  ccuncsy  UC  Santa  Samara  UOraty  Aerial  Pnoiograpny  Collection  (gs*l«_1  6t| 

https://millsf  ield.sfomuseum.org/map/#  1 956/bg/16/37.6 1 60/- 1 22.3847 


1956  fc] 


Figure  8:  Screenshot  of  a  1956  aerial  photograph  ofSFO  overlaid  with  the  airport's  architectural  footprint  (c.  2018). 


Like  the  example  of  the  Olympic  Stadium  in  Sarajevo,  SFO  in 
1956  https  : //mil Is field. sfomuseum.org/buildings/1159396 
32  9/  was  a  different  place  than  it  was  in 

1980  http  s : //mil Is field. sfomuseum.org/buildings/1159396 
32  7/  than  it  will  be  in  20 1 9 ,  when  the  newly  refurbished  Terminal 

1  reopens  as  the  Harvey  B.  Milk 

Terminal  https : / /WWW. f lysf o. com/ media/pres s-releases/sf o- 
unveils-designs-terminal-l-harvey-b-milk-terminal  .  Milk, 

an  activist  and  civil  rights  leader  and  member  of  the  San  Francisco 
Board  of  Supervisors,  had  not  even  moved  to  California  in  1956  nor 
had  construction  on  Terminal  1  (first  called  South  Terminal)  begun. 

In  fact,  the  physical  envelope  of  the  airport  complex  has  changed  so 
much  so  that  the  pre- security  common  area  in  Terminal 

2  https : / /millsfield. sfomuseum.org/commonareas/11591573 
2  7  is  the  only  architectural  element  from  the  airport,  circa  1956, 
that  still  exists  in  2019.  It  bears  repeating:  The  WOF  data  model 
allows  us  to  contextualize  objects  and  events  from  the  aviation 
collection  with  the  airport  as  it  existed  at  a  specific  moment  in 
time.  We  model  a  new  instance,  or  record,  of  the  airport  terminal 
complex  for  each  passenger-facing  “phase  change.” 


Figure  9:  Screenshot  of  early  work  modeling  the  relationship  between  the  multiple  instances  of  boarding  areas,  terminals 
and  the  larger  airport  complex  at  SFO  as  a  directed  graph. xs 


The  terminal  complex  is  said  to  be  the  set  of  buildings  that  the 
general  public  might  reasonable  expect  to  ’'be"  the  airport.  It  does 
not  include  administrative  or  other  buildings  and  is  distinct  from  the 
larger  SFO  campus.  A  "phase  change"  is  any  significant  change  or 
alteration  to  the  airport  that  a  passenger  may  experience,  typically 
the  opening  or  closing  of  a  terminal  or  a  boarding  area.  When  one  of 
these  events  occurs,  both  the  old  and  new  record  are  updated  to 
reference  one  another,  using  the  WOF  "wof: supersedes"  and 
"wof:supersed  by"  properties. 


For  example  the  abbreviated  record  for  Terminal  3  (2011- 

14)  https : / /millsfield. sfomuseum.org/terminals/11593961 

41/  ,  which  superseded  Terminal  3  (2006- 

11)  https : / /millsfield. sfomuseum.org/terminals/11593961 


67/  and  was  itself  superseded  by  Terminal  3  (2014- 

17)  https : / /mills field . sfomuseum.org/ terminals/ 1 159396 1 

57/  is: 


"properties"  { 

"edtf :cessation" : "2014~" , 

"edtf : inception" : "2011~" , 

"wof :id":1159396141, 

"wof : name ": "Terminal  3", 

"wof : superseded_by " : [ 

1159396157 

], 

"wof : supersedes " : [ 

1159396167 

] 

> 

Note  the  use  of  the  "edtf:"  prefixed  properties  to  encode  start  and  end 
times  for  the  terminal  using  the  EDTF  syntax  for  approximate  dates. 


For  every  new  terminal  complex,  we  also  create  a  new  record  for 
each  of  its  descendants,  from  terminals  to  boarding  areas  to  galleries. 
This  introduces  a  non-zero  amount  of  overhead,  both  conceptually 
and  for  the  tooling  used  to  manipulate  these  records,  that  can  be 
unexpected  and  may  seem  unwarranted.  For  example,  there  were  no 
significant  passenger-facing  changes  in  Terminal  3  between  the 
opening  of  Boarding  Area  E  in 

1981  http  s : //mil Is field. sfomuseum.org/terminals/1159554 
819/  and  its  subsequent  closure  for  renovations  in 
2011  http  s : //mil Is field . sfomuseum.org/boardingareas/ 11593 
96185/  (reopening  again  in 

2014  https  : / /millsf ield. sfomuseum.org/boardingareas/1159 


39  6185/  ) ,  yet  there  are  five  distinct  records  for  Terminal  3:  1981- 

83  https : / /millsf ield. sfomuseum.org/terminals/115939612 

9/  ,1983- 

1988  http  s : //millsf ield. sfomuseum.org/terminals/1159554 
819/  ,1988- 

2000  http  s : / /millsf ield. sfomuseum.org/terminals/1159554 
821/  ,2000- 

2006  https  : //millsf ield. sfomuseum.org/terminals/1159396 

123/  and  2006- 

2011  http  s : //millsf ield . sfomuseum.org/ terminals /I 159396 
167/  . 

Each  of  these  instances  signals  a  phase-shift  in  some  other  part  of  the 
larger  airport,  thus  changing  the  overall  context  in  which  T3  itself 
existed.  We  feel  that  this  additional  complexity  is  an  acceptable 
trade-off  on  the  grounds  that  it  is  easier  to  stitch  things  together  than 
it  is  to  pull  them  apart  again,  typically  with  imperfect  data. 

For  example,  SFO  Museum  needs  to  be  able  address  both  of  these 
requests  equally: 

•  Show  me  everything  in  the  terminal  now  called  " T3 ." 

•  Show  me  only  photos  from  a  particular  instantiation  of 


Because  historical  relationships  are  modeled  as  a  linked-list  of  one 
record  superseded  by  another  the  first  question  ( “ Show  me 
everything  in  the  terminal  now  called  " T3 ")  is  easier  to  answer, 
requiring  only  a  small  amount  of  additional  computation  to  traverse 
that  linked-list.  The  second  question  {“Show  me  only  photos  from  a 
particular  instantiation  of  " T3  ” "  demands  strict  naming  conventions 
when  describing  things  as  well  as  constantly  updated  rules  and 
safeguards  to  account  for  lapses  in  data  entry. 


SFO  Terminal  Complex  (1963~- 1974~) 

This  building  supersedes  SFO  Terminal  Complex  (1954~  - 1963~)  and  is  also  superseded  by  SFO  Terminal  Complex  (1974~  - 1979~) 


Terminals  Boarding  Areas 


Figure  10:  Screenshot  of  the  SFO  Museum  web  page  for  the  SFO  Terminal  Complex  c.  1963-74  showing  the  geographic 
footprint  of  the  airport  at  the  time  overlaid  on  the  airport’s  contemporary  footprint . 


Having  discrete  and  importantly  linked  records  off  of  which  we  can 
hang  context- specific  properties,  like  dates  and  alternate  names, 
allows  us  to  make  "simple  things  easy  and  hard  things  possible,"  so 


the  penalty  of  having  to  juggle  additional  records  is  deemed 
acceptable. 


A  Short  Detour:  Naming  Things 

A  fuller  discussion  on  the  nuance  and  complexities  of  naming  things, 
in  general,  and  how  those  names  are  encoded  in  WOF  documents  is 
out  of  scope  for  this  document,  but  precisely  because  naming  things 
is  so  important,  a  short  detour  is  warranted  in  order  to  address  the 
repeated  use  of  the  "wofmame"  property  in  the  examples  used  in  this 
paper. 

The  "wofmame"  descriptor  is  one  finite  set  of  required  properties  in 
WOF,  and  it  is  expected  to  be  the  7-bit  ASCII  transliterated  English 
value  of  a  name.  This  reflects  a  desire  to  have  a  single  default 
naming  scheme  for  all  the  places  in  the  WOF  data  set.  Although  the 
decision  was  made  (in  2015)  to  standardize  on  English  for  the 
"wofmame"  property  that  does  not  mean  the  default  will  only  ever  be 
English.  At  some  future  date,  it  may  be  Chinese  or  Spanish  or 
another  language.  The  criteria  for  the  "wofmame"  property  is  only 
that  there  is  a  default  name  and  that  is  the  same  across  all  records. 

Translations  as  well  as  variant,  historical,  and  colloquial  names  are 
supported  and  described  through  the  use  "name: "-prefixed  properties 
following  the  RFC  5646  standard  for  identifying  languages.  For 
example,  the  abbreviated  WOF  record  for  the  city  of  San 


Francisco  https : / / spelunker .whosonf irst . org / id/85922583 
/  looks  like  this: 


"properties":  { 

"name:eng_x_colloquial" : [ 

"City  by  the  Bay", 

"City  of  the  Golden  Gate", 
"Fog  City", 

"Fog  Cty" , 

"Frisco" , 

"Golden  City", 

"S  Fran", 

"S.  Fran", 

"San  Fran", 

"The  City", 

"S.F.", 

"Bay  Area", 

"S .F.  Bay  Area" , 

"The  City  by  the  Bay", 
"Baghdad  by  the  Bay", 

"The  Paris  of  the  West", 
"Ess  Ef f " , 

" SFC" , 

"San  Francisco  City" 

]# 

" name : eng_x_pref erred" : [ 

"San  Francisco" 

]# 

"name : spa_x_pref erred" : [ 

"San  Francisco" 

]# 

"name : spa_x_variant " : [ 

"Ciudad  de  San  Francisco" 

]# 

"name : sqi_x_pref erred" : [ 

"San  Francisco" 

]# 

"name :yue_x_pref erred" : [ 

]  , 

" name : zho_x_pref erred" : [ 

] , 

"wof lid” :85922583, 

"wof : name "San  Francisco" 

} 


This  same  model  has  already  been  applied  successfully  to  represent 
the  many  different  way  airports  and  airport  terminals  are  labeled 
(abbreviations,  historical  names,  etc.)  and  could  also  be  applied  to 


things  like  credit  lines  for  objects.  For  further  details  on  the  process 
of  evaluating  and  updating  multilingual  names  in  WOF  consult  the 

Concordances  with  Wikipedia 

data  https://whosonfirst.org/blog/wikipedia-data/  (Olga 

Kavvada)  and  Increasing  Name  Translations  in  Who’s  On 

First  https : / /whosonf irst . org/blog/2 0 17/ 08/22/ summer- 
2017  -wof  /  (Nathaniel  Douglass  and  Stephen  Epps)  blog  posts  on 
the  Who’s  On  First  Weblog  https://whosonfirst.org/blog/ 


Diverging  from  (” Breaking”)  Who’s  On 
First 


Boeing  747 

This  aircraft  is  manufactured  by  Boeing 
This  aircraft  is  related  to  Boeing  (the  company) 


This  map  does  not  depict  exactly  where  Boeing  747  is  from  but  rather  its  approximate  location.  Think  of  it  as  being  more 
"around  here"  than  say  another  place  in  the  world. 


Here  are  three  random  images  of  Boeing  747 

There  are  35  images  of  this  aircraft  /  or  just  jump  to  random  image 


United  Airlines  Boeing  747-422 
N119UA 

This  photo  was  taken  by  Flickr 
user  Kambui.  It  was  taken  on  Oct 
6,  2017  and  was  published  under 
the  Creative  Commons  Attribution- 
NonCommercial-ShareAlike 
license.  It  is  not  part  of  the  SFO 
Museum  collection. 


N180UA 

This  photo  was  taken  by  Flickr 
user  Kambui.  It  was  taken  on  Oct 
6,  2017  and  was  published  under 
the  Creative  Commons  Attribution- 
NonCommercial-ShareAlike 
license.  It  is  not  part  of  the  SFO 
Museum  collection. 


B-18715  LAX 


This  photo  was  taken  by  Flickr 
user  airiines470.  It  was  taken  on 
Apr  16,  2015  and  was  published 
under  the  Creative  Commons 
Attribution-ShareAlike  license.  It 
is  not  part  of  the  SFO  Museum 
collection. 


Figure  11:  Screenshot  of  the  SFO  Museum  web  page  for  the  Boeing  747 


In  the  fall  of  2018,  having  successfully  modeled  the  airport’s 
architecture  over  time,  we  began  to  investigate  using  WOF  for  things 
not  explicitly  geographic  in  nature.  That  is  for  things  which  are  not 
places  themselves  but  for  which  place  is  an  integral  feature.  For 
example  an  historical  map  of 

SFO  http  s : / /mil Is field . sfomuseum.org/blog/ 2018/08/07/old 
-maps/  is  about  SFO.  An  airline  or 

aircraft  https : / /millsfield. sfomuseum.org/blog/2018/12/ 03/ 
airlines/  in  SFO  Museum’s  collection  is  from  or  manufactured  in 
a  city  or  country.  A  photograph  of  an 

airport  https : / /millsfield . sfomuseum.org/blog/ 2019/01/02/ 
surface/  depicts  a  place. 


This  work  has  caused  us  to  deliberately  overload  the  semantics  of  the 
“place  type”  property,  in  both  the  "wof:"  and 
"sfomuseum:"  namespaces,  which  is  an  approach  that  will  likely 
need  to  be  revisited  in  time.  As  of  this  writing  the  list  of  overloaded 
terms  includes: 


SFO  Museum  place 
type 

map 

airline 

aircraft 

image 

flight 


Unofficial  Who’s  On  First  place 
type 

map 

enterprise 

instrument 

media 

event 


It  is  important  to  note  that  a)  none  of  these  things  are  actual  "places" 
or  even  "types"  of  places  and  b)  none  of  these  unofficial  WOF  place 
types  are  recognized,  let  alone  supported  by  the  WOF  project.  We 
are  deliberately  overloading  the  meaning  of  things  as  a  way  to 
continue  taking  advantage  of  a  tool  chain  designed  for  a  different 
purpose. 

The  benefits  of  re-purposing  and  adapting  the  WOF  data  format  for 
things  that  aren’t  principally  spatial  in  nature  have  proven  to  be 
greater  than  the  downsides  of  not  adopting  a  more  collection-centric 
standard  or  the  penalty  of  confusing  otherwise  disjoint  data  models. 
Place  is  inseparable  from  the  function  of  an  airport.  Airports  exist  to 
enable  air  travel  between  places  (cities,  countries,  other  airports,  and 
so  on). 


John  F  Kennedy  International  Airport  (1943) 

This  airport  in  United  States  is  also  referred  to  as  JFK  or  sometimes  KJFK  /  See  all  the  airports  /  or  a  random  airport  /  or  just  SFO 


Does  the  shape  of  this  airport  look  a  bit  weird?  That's  probably  because  the  geometry  was  derived  from  the  outline  of 
geotagged  Flickr  photos  and  a  better,  openly  licensed,  alternative  hasn't  been  found  yet. 


Here  are  three  random  images  of  John  F  Kennedy  International  Airport 

There  are  4  images  of  this  airport  /  or  just  jump  to  random  image 


TWA  Flight  Center  Open  House 
NYC  -  10/16/2011  -  53 


NYC  -  JFK  Airport:  TWA  Flight 


20121010  031 


This  photo  was  taken  by  Flickr 
user  Kai  Brinker.  It  was  taken  on 
Oct  17,  2011  and  was  published 
under  the  Creative  Commons 
Attribution-ShareAlike  license.  It 
is  not  part  of  the  SFO  Museum 
collection. 


This  photo  was  taken  by  Flickr 
user  wallyg.  It  was  taken  on  Oct 
16, 2011  and  was  published  under 
the  Creative  Commons  Attribution- 
NonCommercial-NoDerivs 
license.  It  is  not  part  of  the  SFO 
Museum  collection. 


This  photo  was  taken  by  Flickr 
user  k_dellaquila.  It  was  taken  on 
Oct  13, 2012  and  was  published 
under  the  Creative  Commons 
Attribution-Noncommercial 
license.  It  is  not  part  of  the  SFO 
Museum  collection. 


Figure  11:  Screenshot  of  the  SFO  Museum  web  page  for  John  F  Kennedy  International  Airport. 


The  mandate  of  SFO  Museum’s  permanent  collection  is  to  tell  the 
story  of  the  airport  so  the  ability  to  frame  that  story  using  an  existing 
and  widely  deployed  gazetteer  is  immensely  valuable.  When  another 
service  or  enterprise  that  uses  WOF  talks  about  a  place,  we  want  to 
be  able  to  quickly  and  unambiguously  find  items  in  our  collection 
related  to  that  place.  We  also  want  this  approach  to  extend  beyond 
the  objects  in  the  permanent  collection  to  include  the  place  of  origin 
for  loan  objects  as  well  as  the  places  that  objects  in  temporary 
exhibitions  depict. 

We  want  passengers  who  are  traveling  to  the  San  Francisco  Bay 
Area  to  know,  for  example,  that  SFO  Museum  displayed  Preston 
Gannaway’s  photographs  of  The  Farms  of  West 

Oakland>  https : / /WWW. flysfo.com/museum/ exhibitions /pres t 
on-gannaway-f  arms-west-oakland  as  a  function  of  their 
destination.  We  want  to  enable  airlines  and  third-party  developers  to 
be  able  to  associate  a  person’s  journey  with  the  objects  in  our 
collection,  both  permanent  and  temporary,  using  the  journey  itself  as 
the  avenue  in  to  the  museum.  Whether  it’s  "Radios  produced  in 
Pittsburgh  .  .  ."  or  "Objects  from  museums  in  San  Diego  .  .  ."  or 
"Stuff  you’ve  shown  from  museums  in  towns  serviced  by  the  airport 
I’m  flying  to  ..."  or  "Pictures  taken  in  France  .  .  .,"  as  a  practical 
matter  we  need  an  open,  stable,  and  easy-to-use  database  of  places  (a 
gazetteer  like  Who's  On  First)  that  a  broad  range  of  services  beyond 
the  museum  can  use  to  make  answering  these  questions  possible. 


Modeling  objects  or  enterprises  or  depictions  as  WOF  records  is  not 
obvious  and  demands  a  leap  of  faith.  It  is  a  relatively  small  leap 
when  you  consider  that  all  of  these  non-place  records  can  take 
advantage  of  everything  WOF  offers  from  tooling,  to  built-in 
location  data,  to  a  robust  and  flexible  set  of  metadata  properties  and 
ways  to  track  relationships  and  represent  ambiguity  over  time. 

This  last  point  is  especially  interesting  to  SFO  Museum  since  it 
provides  a  way  to  represent  the  complex  and  twisty  associations  that 
have  existed  between  airlines  and  their  parent 

Companies  https  :  / /millsf  ield .  sf  omuseum.  org/blog/2  018/12/ 
03/airlines/  since  the  advent  of  commercial  aviation . 


Going  forward,  we  plan  to  extend  this  approach  to  individual  objects 
in  the  SFO  Museum  collection  as  well  as  the  constituent  associated 
with  them.  WOF’s  support  for  multiple 

geometries  https  :  / /millsf  ield.  sfomuseum.org/blog/2019/ 01/ 
14 /gates/  associated  with  a  single  record  may  prove  especially 
useful  when  modeling  many  different  places  that  any  one  constituent 
may  have  lived  or  worked  in  over  the  course  of  their  life. 

Publishing  (as)  Who’s  On  First 

SFO  Museum  publishes  all  of  the  data  described  in  this  paper  as 

open-data  under  the  Community  Data  License 

Agreement  https://cdia.io/  (CDLA)  1.0,  developed  by  the 


Linux  Foundation  https://www.linuxfoundation.org/  .Data 
are  published  as  SQLite 

databases  https : //millsf ield. sfomuseum.org/distributions/ 
sqiite/  on  our  own  website  and  as  Git  repositories  under  the 

sfomuseum-data  GitHub 

organization  http://github.com/sfomuseum-data  . 

Data  publications  are  grouped  by  the  class  of  items  they  contain: 


repository 

notes 

sfomuseum- 

WOF  records  for  places  related  to  SFO  and 

data- 

SFO  Museum  (countries,  campuses,  etc.); 

whosonf irst 

these  files  are  cloned  from  WOF  itself 

sfomuseum- 

Buildings,  terminals,  boarding  areas  and 

data- 

galleries  at  SFO 

architecture 

sfomuseum- 

SFO  Museum  exhibitions 

data- 

exhibition 

sfomuseum- 

Airlines  and  companies  related  to  the  SFO 

data- 

Museum  collection 

enterprise 

sfomuseum- 

Aircraft  related  to  the  SFO  Museum 

data- 

collection 

aircraf t 

sfomuseum- 

Aerial  maps  of  SFO  airport 

data-maps 

sfomuseum- 

SFO  Museum  produced  media  items 

data-media 


repository  notes 

sfomuseum-  Selected  Creative  Commons  licensed  Flickr 

data-media-  photos  relevant  to  the  SFO  Museum 
flickr 

sfomuseum-  Flight  data  for  commercial  airlines  arriving  at 

data-  or  departing  from  SFO  (experimental) 

flights-* 

Data  will  also  be  made  available  through  a  public  web-based 
application  programming  interface  (API)  in  early  2019. 

Who’s  On  First  Data  in  Practice 

These  published  data  sets  are  what  SFO  Museum  itself  consumes  to 
populate  and  run  its  own 

Hlillsfield.sfoinilSeilin.org  https  :  //millsf  ield .  sfomuseum.org 
/  website.  This  website  operates  alongside  SFO  Museum’s  existing 
online  presence  and  collections  website,  which  is  part  of  the  airport’s 
flysfo.com  https://fiysfo.com  website.  The  Mills  Field  project 
and  website  is  described  as: 


[A]  place  to  consider  what  it  means  for  a  museum  in 
an  airport,  an  airport  with  over  55  million  visitors  in 
2017,  to  operate  in  a  world  where  (almost)  everyone 
is  connected  to  the  Internet.  It  is  a  place  to  learn 
what  are  the  opportunities  and  what  are  our 
responsibilities,  as  a  cultural  heritage  organization, 
to  everyone  who  passes  through  SFO  equipped  with 
curiosity  and  a  computer  connected  to  the  network? 


[It]  is  not  an  experiment  or  a  ‘labs  ’  project.  It’s  not 
even  our  official  website.  It  is  a  work  in  progress  to 
understand  and  to  share  the  arc  of  our  direction  as 
we  answer  the  question  above.  To  determine  where 
we  are  going,  where  all  these  technologies  will  take 
us,  and  to  invite  you  along  for  the  ride. 


The  Mills  Field  website  is  where  everything  described  in  this  paper 
is  given  form  and  proven,  or  just  as  importantly,  disproven.  SFO 
Museum’s  ambition  for  digital  projects  extend  beyond  a  single 
website,  but  we  use  this  website  as  a  foundational  layer  on  top  of 
which  everything  else  we  do  will  be  built. 

As  mentioned  at  the  beginning  of  this  paper,  SFO  Museum  has 
begun  its  efforts  at  the  macro-level  (the  whole  world)  and  has  been 
working  its  way  down  to  the  collection  itself.  The  reason  for  starting 
with  everything  that  surrounds  an  object,  whether  it  is  a  country  or 


an  airport  or  an  airline  or  the  gallery  space  where  an  object  was 
displayed  in,  is  to  ensure  a  stable  and  durable  infrastructure  that 
allows  each  and  every  one  of  those  facets— facets  that  are  common 
currency  in  people’s  day-to-day  lives— to  act  as  a  conduit  back  to 
those  objects  and  the  larger  SFO  Museum  collection. 


Airports  in  South  Africa 

These  are  not  all  the  airports  in  South  Africa  but  they  are  airports  that  hold  hands  with  SFO  Museum  /  See  all  the  countries  /  or  all 
the  airports 


Bram  Fischer  International  Airport  fuuuu) 

This  airport  in  South  Africa  is  also  referred  to  as  BFN  or  sometimes  FABL 
Cape  Town  International  Airport  (1954> 

This  airport  in  South  Africa  is  also  referred  to  as  CPT  or  sometimes  FACT 
OR  Tambo  International  Airport  (1952) 

This  airport  in  South  Africa  is  also  referred  to  as  JNB  or  sometimes  FAOR 


Figure  12:  Screenshot  of  the  SFO  Museum  Web  page  for  airports  related  to  the  SFO  Museum  collection  from  the  country 

of  South  Africa. 


We  also  want  this  infrastructure  to  be  open  and  available  to  others, 
from  amateur  enthusiasts  to  third-party  developers  to  other  groups  at 
the  airport  itself.  We  want  them  to  be  able  to  fashion  their  own 
applications  from,  interpretations  of,  and  uses  for  the  SFO  Museum 
collection.  Therefore,  it  is  important  to  SFO  Museum  that  we  are 
building  our  own  public-facing  services  on  top  of  the  same  open  data 
we  produce  for  general  consumption.  If  we  hope  and  expect  others  to 
build  something  interesting  from  our  data  then  we  should  be  able  to 
prove,  if  only  to  ourselves,  that  we  can  too. 


While  it  remains  early  days  in  the  project  the  decision  to  explicitly 
model  the  SFO  Museum  collection  in  space  and  time  has  thus  far 
proven  fruitful.  By  promoting  place  and  history  as  first-class 
properties  associated  with  every  aspect  of  our  collection,  and  by 
extension  the  airport  in  which  it  is  housed,  we  are  able  to  offer  as 
many  avenues  as  there  are  (or  have  been)  places  back  in  to  the 
collection  itself. 


2019-04-04 


post-modern  late-capital  ism 
or  late-capitalist  post¬ 
modernism? 

#mw19  -  the  presentation 
#mw19  -  the  word/drawings 


#mw19  -  the  presentation 


These  are  the  slides  and  notes  for  a  talk  I  gave  at  the  2019  Museums 
and  the  Web  https :  /  / mwi  9 .  mwconf .  or g  conference,  in  Boston . 
The  talk  accompanied  a  paper  I  wrote  for  the  conference  titled 
Mapping  Space ,  Time ,  and  the  Collection  at  SFO 
Museum  https  :  //mwl9  .mwconf  .  org/paper/mapping-space- 
time-and-the-collection-at-sf o-museum/  which  documents  the 
work  we've  been  doing  on  the  Mills 

Field  https://millsfield.sfomuseum.org/  website  at  SFO 
Museum  https://sfomuseum.org/ 


Although  the  talk  focuses  on  the  work  we're  doing  at  SFO  it  is  the 
continuation  of  some  broader  themes  I've  been  actively  banging  on 
for  a  while.  If  you'd  like  to  read  more  then  I  would  point  you  to  the 

still  life  with  emotional 

contagion  https : / /www. aaronland. inf o/weblog/2014/ 09/11/br 
and/#dconstruct  and  this  is  my  brick  /  there  are  many  like  it  but 
this  one  is 

mine  https : / /www. aaronland . inf o/weblog/20 14/ 10/ 06/ interp 
retation/#brick  talks,  both  from  2014,  the  history  is  time 
breaking  up  with 

itself  https  :  / /www. aaronland.  info/weblog/2015/ 03/16/mentio 
n/#breaking-up  talk  from  2015  and  the  fault  lines  —  a  cultural 
heritage  of  misaligned 

expectations  https : //www. aaronland . info/weblog/2017/ 02/20/ 
mostly/#museumnext  talk  from  2017 . 


In  2019,  this  is  what  /  said. 


Hi,  my  name  is  Aaron. 

I  am  the  Head  of  Internet  Typing  at  the  San  Francisco 
International  Airport  Museum  https://sfomuseum.org/  .  As 
silly  as  a  title  like  that  may  sound  (and  I  actually  have  an  even  more 
vague  and  opaque  official  title  for  HR  purposes)  it  is  the  best  way  to 
describe  my  role  at  the  museum. 

In  the  past  I  have  been  part  of  the  teams  at 
Flickr  https://www.flickr.com/  , 

Stamen  https://www.stamen.com/  Design  and 

Mapzen  https://www.mapzen.com/  where  the  common  thread 

has  been  maps  and  location.  I  was  also  part  of  the  Digital  and 


Emerging  Media  https :  / / labs .  cooperhewitt .  org/  team  at 

the  Cooper  Hewitt  Smithsonian  Design 

Museum  https://www.cooperhewitt.org/  helping  to  re-open 
the  museum  and  launch  the 

Pen  https : / /mw20 15 . museums andtheweb . com/paper/ strategies 

-against-architecture-interactive-media-and- 

transf ormative-technology-at-cooper-hewitt/  in  2014. 


The  San  Francisco  International 

Airport  https://www.fiysfo.com/  ,  or  SFO,  first  opened  in 
1927  on  the  site  of  the  old  Mills 

Field  https : / /mills field . sfomuseum.org/blog/2018/ 08/08/ 
why/  in  San  Mateo  County.  Although  SFO  is  physically  situated  in 
San  Mateo  it  is  owned  and  operated  by  the  City  and  County  of  San 
Francisco  https :  list  gov .  org  /  .  Like  the  Farallon 
Islands  https://en.wikipedia.org/wiki/Farallon_Islands  , 

30  miles  off  the  Pacific  Coast,  SFO  is  actually  part  of  San  Francisco 
proper  but  unlike  the  Farallons  is  never  shown  that  way  on  a 
map  https : / /mills field . sfomuseum.org/blog/2019/ 01/14/ gat 
es/images/sf-centroids . png 


SFO  is  the  20th  busiest  airport  in  the  world  and  7th  busiest  in  the 
United  States.  Last  year,  approximately  58  million  passengers  flew 
and  out  of  the  airport. 


Reflections  in  Wood  -  Surfboards  and  Shapers  (2019) 


Since  1980  the  airport  has  had  a  museum.  First  accredited  in  1999 
the  museum  currently  has  37  full-time  and  up  to  24  part-time  staff. 

This  is  a  photograph  of  the  "Reflections  in  Wood  -  Surfboards  and 
Shapers  https : / /millsf ield . sfomuseum.org/ exhibitions/ 13 7 
6812931/  "  exhibition  currently  on  display  in  the  International 
Terminal.  Everything  you  see  in  this  photo  -  from  the  curatorial 
programming,  to  registration  and  conservation,  handling,  exhibition 
design,  fabrication  and  installation  as  well  as  the  graphic  design  and 
photography  -  all  of  this  was  done  in-house. 


This  is  the  work  of  my  peers  and  they  do  this  30  to  40  times  a  year, 
80  if  you  include  the  recently  inaugurated  video  arts 


program  https : / /WWW. f lysfo . com/museum/programs/video- 
arts -history  .  I  just  sit  in  the  corner  pecking  away  at  a  keyboard 
connected  to  the  internet. 


In  addition  to  the  almost  1,400 

exhibitions  https : / /millsf ield. sfomuseum.org/ exhibitions 
/years/  the  museum  has  produced  since  1980  it  has  a  permanent 
collection  of  130,000 

objects  https : / /www. f lysf o . com/museum/ aviation-museum- 
library/collection  related  to  the  history  of  the  airport  and 
commercial  aviation.  We  also  maintain  a  library  and  an 
archive  https : //www. flysfo.com/museum/ aviation-museum- 
library/  research-services  of  materials  related  to  the  aviation 
collection. 

At  any  given  moment  there  are  upwards  of  1,000  objects  on 

display  https : //millsf ield. sfomuseum.org/exhibitions/on- 


display/  in  the  terminals . 


On  top  of  all  of  that  we  are  charged  with  the  care  of  the  one 
hundred  plus  public  artworks  purchased  by  the  San  Francisco 
Arts  Commission  https  :  / /WWW.  f  lysf  o .  com/museum/ public - 
art/ public-collection  and  installed  on  the  airport  property. 


Bowling:  A  Unique  American  Art  Form  (1991) 


You  might  be  wondering:  How  did  all  of  this  happen? 

The  answer  is  basically  that  in  the  1970s  the  airport  commissioners 
decided  SFO  should  be  a  "nice  place"  to  visit.  The  Bay  Area,  and 
San  Francisco  in  particular,  is  complicated  and  has  gotten  a  lot  of 
things  wrong  over  the  years.  Sometimes  though,  when  it  cuts  loose 
and  gets  it  right  https  :  /  / thesixf  if  ty .  com/ get-to-know-the- 
curator-behind-many-of-sf os -world-class -museum-exhibit s- 
773068a4f  f  98  you  end  up  with  a  museum  in  an  airport. 


Japanese  Toys!  From  Kokeshi  to  Kaiju  (2013) 


If  you  measure  things  by  foot  traffic  we  are  one  of  the  busiest 
museums  in  the  world.  If  that  is  the  case  we  are  also  one  of  the 
busiest  museums  in  the  world  that  no  one  knows  about.  Nothing  in 
modern  life  really  prepares  you  for  the  idea  that  a  museum  should  be 
part  of  an  airport.  San  Francisco,  as  I've  mentioned,  is  funny  that 
way. 

People  often  ask:  Where  is  the  museum?  Almost  no  one  is  aware  that 
there  are  over  twenty  gallery  spaces  spanning  the 
terminals  https://millsfield.sfomuseum.org/galleries  , 
both  before  and  after  security.  Over  the  years  there  have  been  three 
times  that 


number  https://millsfield.sfomuseum.org/galleries/all/  , 

rotating  in  and  out  as  the  airport  has  grown  and  changed. 

So,  in  a  very  real  sense  the  airport  is  the  museum. 


If  people  are  ill-equipped  to  deal  with  the  idea  of  a  museum  in  an 
airport  they  are  even  less  prepared  to  consider  the  idea  that  one  has 
been  there  for  the  last  39  years.  Lots  of  people  will  tell  you  about 
one  or  two  exhibitions  they've  seen  in  a  particular  terminal  but  rarely 
have  any  idea  of  all  the  things  that  have  come  before 

it  https : //mil Is field . sfomuseum.org/ galleries /I 159157053/ 
exhibitions /all  in  that  very  same  spot. 


That's  where  the  work  I 

do  https://millsfield.sfomuseum.org/  Comes  in  to  the 
picture. 

What  is  the  promise  of  the  internet  -  and  in  particular  the  web  -  if 
not  the  stringing  together  of  all  the  things  that  came  before  or  that 
follow  any  given  moment? 


When  people  ask  me  what  I  am  doing  I  tell  them  it  is  "to  ensure 
that  every  aspect  of  a  trip  to  SFO,  and  every  facet  of  someone’s 
time  spent  in  the  airport,  leads  back  to  the  museum’s  collection" 
and  that  we  are  using  the  internet  to  make  that  possible. 


That  means  the  terminal  you're  standing  in  or  the  boarding  gate 
you're  waiting  at,  the  airline  or  aircraft  you're  flying  on,  the  places 
you're  traveling  to,  the  gallery  space  you're  looking  at  or  the  places 
the  objects  in  an  exhibition  are  from.  All  of  it.  And  all  of  it  holds 
hands  in  some  way  with  our 

collection,  https  :  /  /mil  Is  field .  sfomuseum.org/ collection/ 


By  the  way  this  is  not  how  I  see  my  role  in  relation  to  the  airport  or 
the  museum.  This  is  a  mock-up  I  made  to  suggest  installing  the 
dinosaur  that  used  to  be  on  display  in  the  old  Terminal  2  out  on  the 
airfield.  It's  unlikely  to  ever  happen  but  it's  a  nice  idea,  right? 


what 

how 

why 


I  have  also  written  a  5,000  word  paper  about  that 

Work  https : / /mwl9 .mwconf . org/paper/mapping-space-time- 
and-the-coiiection-at-sf  o-museum/  for  this  conference  and  I 
don't  want  to  spend  my  time  with  you  today  parroting  everything  I1 
already  said  there. 


what 

-  5,  000  word  paper 

how 

why 


I  want  to  do  a  high-level  overview  of  the  what  and  how  discussed  in 
detail  in  the  paper  so  that  we  can  spend  a  little  more  time  on  the  why. 


what 

how 

why...  but  really 


And  then  a  little  more  time  still  on  how  I  see  our  work  in  the  context 
of  some  larger  sector- wide  dynamics  that  I  believe  we  all  need  to 
address. 


To  explain  what  we're  doing  I  need  to  begin  with  some  basic 
statements  of  truth  in  our  world: 


•  That  the  notion  of  place  is  inseparable  from  an 
airport.  After  all  everyone  passing  through  our  doors 
is  coming  from  or  going  to  some  place. 

•  Like  the  passengers  everything  the  museum  displays  in 
its  gallery  cases  is  also  from  some  place. 

•  Part  of  SFO  Museum's  mandate  is  the  history  of  the 
airport. 


History  is  inseparable  from  place. 


With  that  in  mind  we  have  made  place  and  time  (history)  the  joints  - 
really  a  kind  of  double -joint  -  around  which  everything  in  the 
collection  pivots.  Everything  means  individual  objects  all  the  way  up 
through  the  terminals  and  the  airport  itself  and  then  beyond  SFO  to 
the  other 

airports  https://millsfield.sfomuseum.org/airports/  , 

Cities  https://millsfield.sfomuseum.org/cities/  and 
Countries  https : / /millsf ield . sfomuseum.org/countries/ 
that  are  relevant  to  our  collection.  Then  we  multiply  it  all  by  time 
allowing  any  event  -  an  exhibition,  say  -  to  be  situated  in  a  context 
relevant  to  that 

moment  https  :  / /millsf  ield.  sfomuseum.org/blog/2019/ 01/14 
/gates/ 


SFO  in 

1982  http  s : //millsf ield. sfomuseum.org/buildings/1159396 
32  7/  ,  for  example,  was  a  very  different  place  than  it  is  today  in 
2019  http  s : //millsf ield. sfomuseum.org/buildings/1159157 
271/  . 


For  those  places  outside  the  airport  campus  we  are  using  an  existing 
openly  licensed  gazetteer  of  places  called  Who's  On 
First  https :  //whosonf  irst.org/  for  record  identifiers.  This  is 
our  shared  vocabulary  for  place. 

For  those  places  inside  the  airport  we  are  extending  the  Who's  On 
First 

model  https : / /millsf ield . sfomuseum.org/blog/ 2018/08/28/w 
hosonf  irst/  to  represent  the  buildings  and  interior  spaces  over  the 
years. 

For  example  there  are  multiple  records  for  "  Terminal 

1 "  https : / /millsf ield . sfomuseum.org/ search/ ? 


q=Ti&piacetype=terminai  ,  each  representing  a  unique  phase-shift 
in  its  history.  A  phase-shift  is  defined  as  any  meaningful  change  in 
how  a  passenger  might  experience  that  place.  For  example,  the 
experience  and  the  meaning  of  "Terminal  1"  will  change  once  more 
this  summer  with  the  opening  of  a  new  and  much  larger  terminal 
named  after  Harvey  Milk. 

Each  instance  of  Terminal  1  is  linked  to  the  record  that  precedes  it 
and  the  record  that  follows  it.  We  model  any  and  all  the  architectural 
elements  in  our  collection  this  way  creating  a  tapestry  of 
breadcrumbs  that  spans  both  place  and  history. 


We  are  extending  this  approach  to 

galleries  https://millsfield.sfomuseum.org/galleries/  and 
exhibitions  https: / /millsf ield. sfomuseum.org/exhibitions 
/  as  well  as  things  in  our  collection  that  don't  have  ground  truth; 
they  aren't  physical  places  you  can  visit.  This  includes  objects  and 
constituents,  airlines  and 

aircraft  https : / /millsfield. sfomuseum.org/blog/2018/12/ 03/ 
airlines/  ,  historical  flight 

data  https : / /millsfield . sfomuseum.org/blog/2019/ 0 1/18 /f 
lights/  as  well  as  photographs  of 

things  https : / /millsfield. sfomuseum.org/blog/2019/ 01/02/s 
urf ace/  directly  and  indirectly  related  to  the  collection. 


This  is  ongoing  work  and  we  may  still  paint  ourselves  in  to  a  few 
corners  but  we  think  it  is  a  promising  approach. 

I  have  always  seen  the  Cooper  Hewitt's  search-by-colour 
functionality  https  :  / /web.  archive  .or g /web/ 2 01901 142  2 1103/h 
ttps  :  / / labs  .  cooperhewitt .  org/ 2  013/giv-do/  as  a  deliberate 
attempt  to  manufacture  avenues  in  to  their  collection  for  people  who 
do  not  already  have  an  intimate  knowledge  of  the  decorative  arts.  We 
are  trying  to  do  the  same  thing,  but  with  space  and  time,  for  our 
collection. 


We  are  building  for  the  web  first,  rather  than  targeting  any  of  the  big 
platform  vendors. 

The  web  embodies  principles  of  openness  and  portability  and 
access  that  best  align  with  the  needs,  and  frankly  the  purpose,  of 
the  cultural  heritage  sector. 

We  are  also  publishing  everything  as  openly-licensed  data.  We  have 
chosen  to  publish  everything  using  the 

GeoJSON  https : / /macwright . org/2015/ 03/23/geo j son- 
second-bite  .  html  format  because  it  has  a  near-zero  barrier  to 
entry,  is  flexible  enough  to  accommodate  museum- specific  metadata 
and  because  it  is  supported  by  nearly  every  geospatial  application, 


open  and  closed  source,  on  the  market  today.  Everything  we  publish 
has  location  baked  in  to  it  from  the  start. 


There  is  one  other  important  twist  in  the  way  we  are  publishing  open 
data. 


export 

build 

publish 


Historically  the  model  for  most  digital  or  web-based  initiatives  has 
been  to  first  export  data  from  an  internal  collections  management 
system.  Second,  that  data  is  massaged  in  to  an  intermediate  form  for 
use  by  the  project  at  hand  and  then  third,  exported  again  in  to  a 
typically  bespoke  machine-readable  format. 


export 

export 

build 

publish 

publish 

build 

We  have  changed  the  order  of  things  to  publish  the  open  data 
representation  first  and  then,  from  there,  to  build  our  own  websites 
and  services  on  top  of  that. 


Everything  I've  described  so  far  has  been  built  using  the  same  raw 
materials  https://github.com/sfomuseum-data  that  we've 
made  available  for  you  to  do  something  with.  This  introduces  a  non¬ 
zero  cost  in  the  build  process  for  the  public-facing  museum  efforts 
but  we  believe  it's  worth  the  cost. 


But  why,  right? 


Stepping  Out:  Shoes  in  World  Cultures  (2017) 


First  of  all  we  want  other  people  to  build  new  interfaces  and  new 
services,  new  "experiences"  even,  on  top  of  our  collection  so  this  is  a 
way  to  keep  ourselves  honest.  If  we  can't  build  something  with  this 
stuff  why  should  we  imagine  you  will? 


Second,  we  want  to  ensure  that  the  data  we  release  and  the  manner  in 
which  it  is  published,  is  actually  robust  and  flexible  enough  to 
engender  a  variety  of  interfaces  and  uses  because  we  need  that 
variety.  It  is  important  to  the  museum  because  I  don't  believe  there 
is,  or  should  be,  only  one  master  narrative  in  to  the  collection. 


Barbie®  Takes  A  Vacation  to  Exotic  Places  (1996) 


To  some  degree  all  museums  have  reluctant  audiences.  Our  visitors 
will  not,  and  do  not,  warm  up  to  our  collections  in  the  same  way  or 
at  the  same  pace.  This  is  especially  true  in  an  airport  where  people 
don't  expect  to  find  a  museum  in  the  first  place  and  where  our 
audience  doesn't  fit  neatly  in  to  a  handful  of  demographic  boxes. 


As  such  we  have  an  incentive  to  ensure  that  our  work  affords  us  the 
ability  to  iterate  and  experiment  with  as  wide  a  range  of  interfaces 
and  applications  as  possible,  and  for  them  to  be  just  as  fast  and  cheap 
to  produce  as  they  are  to  sustain  over  long  periods  of  time  and  left  to 
grow  roots,  to  be  nurtured. 


We  need  to  put  in  place  an  infrastructure  that  allows  us  to  manage 
the  cost  of  failure  and  germination,  equally.  A  common  mistake  we 
make  with  digital  initiatives  in  the  cultural  heritage  sector  is  to 
assume  those  are  same  thing.  They  are  not. 

We  need  to  start  designing  around  the  idea  of  false  starts. 


Artist's  Furniture:  New  Dimensions  and  Statements  in  Design  (1982) 


There  is  another,  more  practical,  reason  to  design  for  false  starts: 

In  2019,  if  the  past  is  any  guide,  most  if  not  all  the  digital  initiatives 
we  work  on  today  are  destined  to  fail.  More  likely,  they  will  just  be 
left  to  die  on  the  vine.  Go  ahead  and  take  a  moment  to  admire  this 
beautiful  chair  while  you  let  that  sink  in. 


This  is  the  elephant  in  the  room,  in  every  room  where  we  talk  about 
this  stuff.  It  is  a  complex  and  nuanced  subject,  not  one  we  have  time 
to  discuss  properly  here  but  it's  real.  My  own  feeling  is  that  at  its  root 
it  boils  down  to  the  problem  of  long-term  staffing  that  permeates  the 
sector  -  of  hiring  and  more  importantly  keeping  people  with  the 
requisite  skills  around. 


Saying  that,  though,  also  a  bit  like  being  in  the  middle  of  a  hurricane 
and  complaining  about  the  problem  of  hurricanes.  Right  now,  the 
immediate  problem  is  just  getting  through  to  the  other  side  of  the 
storm. 


Right  now  the  problem  is  thinking  about  how  to  build  things  to 
survive  the  short-term  enthusiasms  and  trigger- finger 
disillusionments  that  seem  to  define  our  efforts.  To  prevent  a  reset  to 
zero  with  each  and  every  false  start. 


At  this  point,  and  based  on  some  conversations  I  had  during  the 
conference,  it's  probably  worth  being  explicit  about  a  couple  things 
in  a  way  that  I  wasn't  during  the  talk. 


First,  saying  that  we  need  to  "manage  the  cost  of  failure "  or  "design 
for  false  starts"  should  not  be  confused  with  the  maxim  of  "failing 
fast  (and failing  often)" .  This  has  been  rightly  called  out  as  a  kind  of 
intellectual  dodge  to  accommodate  and  legitimize  lazy  and  sloppy 
practices  that  don't  consider  or  actively  ignore  their  consequences. 
So,  not  that. 


At  the  same  time  the  worst  possible  outcome  for  the  museum  sector 
would  be  to  use  that  critique  as  an  excuse  to  continue  with  its  own 
problematic  working  practices  that  have  favoured  overpriced 
aspirational  battleships  whose  worth,  whose  success  and  failure,  is 
measured  only  in  third-party  validation. 


There  is  a  way  to  work  fast  and  cheap  and  do  things  the  right  way, 
all  while  being  forgiving  of  honest  mistakes  along  the  way.  It's  hard 
work  to  juggle  all  those  concerns  but  that  is  not  the  same  as 
"impossible" .  Sometimes  failure  really  is  the  manifestation  of 
negligence  but  just  as  often  it  is  the  guide  rail  we  use  to  understand 
the  shape  of  success. 


Second,  to  say  that  everything  we  do  today  "will  fail"  is  not  meant 
suggest  we  should  just  kick  back,  give  up,  get  our  zen  on  and  go  to 
the  bar.  Not  at  all.  It's  pretty  awful  watching  what  has  happened  to 
all  the  good  work  produced  over  the  years.  It's  wrong.  It's  wrong  but 
it  still  happens  and  for  those  reasons  we  need  to  be  clear -eyed  about 
what's  going  on  in  order  that  we  might  figure  out  how  to  stop  it  from 
happening  again  and  again  and  again... 


Building  for  Air  Travel  (1997) 


But  why,  indeed? 


Let's  take  it  for  granted  that  a  core  function  -  again,  a  purpose  -  of 
the  cultural  heritage  sector  is  access.  From  there  let's  imagine  that 
access  can  be  defined  along  an  axis  spanning  broadcast  to  recall. 

Broadcast  being  the  ability  to  have  your  contemporary  efforts  reach 
as  many  people  as  possible  with  the  least  amount  of  friction.  Recall 
being  the  ability  for  those  same  people  to  access  all  that  broadcast 
material  after  the  fact  when  you  have  moved  on  to  some  other 
contemporary  concern. 


The  internet,  it's  clear,  has  been  a  boon  to  both  but  if  we  focus  solely 
on  broadcasting,  on  the  "Channels"  and  on  experiences  in  the 
moment  then  we  are  presented  with  something  of  an  existential 
problem  because  the  humanities  are  predicated  on  the  idea  of 
revisiting  a  subject  or  an  idea  and  on  revisiting  it  repeatedly. 

"The  past  keeps  changing,"  the  historian  Margaret 
MacMillan  http  : //www. margaretmacmillan.com/  has  Said, 
"because  we  keep  asking  different  questions  of  it." 


Put  bluntly:  Without  recall  there  is  little  to  revisit  and  if  there  is  no 
revisiting  is  there  even  a  cultural  history? 


The  internet,  and  specifically  the  web ,  has  made  recall  and  by 
extension  access  possible  in  a  way  that  we  have  genuinely  never 
known  before.  In  2019  the  web  is  not  "sexy"  anymore  and  compared 
to  native  platforms  it  can  sometimes  seems  lacking,  but  I  think  that 
speaks  as  much  to  people's  desire  for  something  "new"  as  it  does  to 
any  apples  to  apples  comparison.  On  measure  -  and  that's  the 
important  part:  on  measure  -  the  web  affords  a  better  and  more 
sustainable  framework  for  the  cultural  heritage  to  work  in  than  any 
of  the  shifting  agendas  of  the  various  platform  vendors. 


For  many  years  I  think  we  all  saw  Tim  Berners  Lee's  decision  to 
make  the  web  open  by  design  as  quaint,  the  actions  of  a  "nice 
scholarly  British  man".  In  recent  years,  as  the  platform  vendors 


(sometimes  called  the 

"Stacks"  https : / /blog . ester ling .co.uk/2012/ 03/16/bruce- 
sterling-on-%E2%80%98the-stacks%E2%80%99/  )  continue  to 
build  higher  and  higher  walls  in  to  and  out  of  their  walled  gardens, 

the  magnitude  of  Berners  Lee's 

choice  https : / / twitter . com/ timberners_lee/ status /22896008 
5672599552  has  become  clearer  and  ever  more  important . 

This  is  why  we  have  chosen  to  do  things  in  the  ways  I  have 
described  to  you  today. 


In  closing  I'd  like  to  leave  you  with  a  passage  from  the  opening  of 

Emily  Wilson's 

translation  https  :  / / chireviewof  books  .  com/ 2018/01/1 6 /how- 
emily-wilson-translated-the-odyssey/  of  Homer's  The 
Odyssey: 


Tell  the  old  story 
for  our  modern  times 
Find  the  beginning 


2019-04-08 
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Also,  spelling  is  hard... 
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things  I  have  written  about 
elsewhere  #20190517 

Harvey  Milk  Plane  Has  a  Permalink-  Updated... 


Harvey  Milk  Plane  Has  a 
Permalink  -  Updated  flight  data 
at  SFO  Museum 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //mil Is fie Id. sfomuseum.org/blog/2019/ 05/17 / flights/  , 

in  May  2019. 


Today  we  are  happy  to  announce  something  that's  actually  been  live  for  a 
couple  weeks  now:  Improved  and  updated  data  for  flights  arriving  at  and 
departing  from  SFO.  This  is  the  proverbial  "version  2"  of  work  that  we  began 
way  back  in 

January  https : //mil Is field. sfomuseum.org/blog/2019/ 01/18/ flights 
/  .  Since  the  beginning  of  May  we  have  been  recording  the  following  data  for 
many  (but  still  not  all)  flights: 


Aircraft  model 


•  Tail  number 

•  Planned  flight  routes 

•  Actual  flight  paths  traveled,  including  elevation 

Here  are  all  the  distinct  aircraft  (models)  we've  seen  so  far: 

https :  //millsfield  .sfomuseum  .org/flights/aircraft/ 

These  are  not  actually  all  the  aircraft.  We  are  excluding  private  aircraft  but  we 
also  know  that  some  flights  are  missing  for  reasons-involving-computers  that 
we  haven't  solved  yet.  For  example,  where  are  all  the  Embraer 
planes  https : //millsfield. sfomuseum.org/ search/ ?q=Embraer  that  we 
know  are  operated  by  airlines  at  SFO?  With  any  luck,  we  will  find  them  soon. 


All  of  the  airplanes  that  have  flown  in  or  out  of  SFO 

Well,  not  really  all  of  them  so  much  as  1,343  of  them  since  we  started  counting 


DAIHT 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

DAIHV 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

HL7579 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

HL7771 


We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

HL8079 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

HP1833 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

HP1844 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

JA739J 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

JA741J 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

JA743J 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

LNRKG 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 

N108NN 

We've  logged  2  flights  for  this  airplane,  since  we  started  counting. 


49  50 

51 

□ 

53  54 

112  -♦ 


Here  are  all  the  individual  airplanes  that  have  visited  the  airport: 

https://millsfield.sfomuseum.org/flights/airplanes/ 

If  you  had  told  me  that  a  little  over  two  weeks  of  data  would  have  yielded 
almost  1,400  unique  airplanes  at  SFO  I  would  have  been  surprised.  I  am 
surprised. 


Airports  that  the  airplane  with  tail  number  N822UA 
has  traveled  to 

These  are  not  all  the  airports  this  airplane  has  visited,  just  the  ones  that  have  flown  in  and  out  of  SFO  since  we've  been 
counting  /  See  all  the  flights  we've  recorded  for  this  airplane  /  Or  all  the  airplanes  we've  logged  so  far 


San  Francisco  International  Airport 

This  airport  in  the  United  States  is  also  referred  to  as  SFO  or  sometimes  KSFO 

There  have  been  17  flights,  since  we  started  counting. 


Palm  Springs  International  Airport 

This  airport  in  the  United  States  is  also  referred  to  as  PSP  or  sometimes  KPSP 

There  have  been  4  flights,  since  we  started  counting. 

Nashville  International  Airport 

This  airport  in  the  United  States  is  also  referred  to  as  BNA  or  sometimes  KBNA 

There  have  been  3  flights,  since  we  started  counting. 

Greater  Cincinnati  International  Airport 

This  airport  in  the  United  States  is  also  referred  to  as  CVG  or  sometimes  KCVG 

There  have  been  2  flights,  since  we  started  counting. 

San  Diego  International  Airport 

This  airport  in  the  United  States  is  also  referred  to  as  SAN  or  sometimes  KSAN 

There  have  been  2  flights,  since  we  started  counting. 


We  have  permalinks  for  every  airplane  we  see  identified  by  its  registration 
number,  sometimes  called  a  "tail 

number"  https : / / en .wikipedia . org/wiki/Aircraf t_registration 

example  the  "Harvey  Milk 


.  For 


Plane"  https : / /WWW. sf gate . com/travel/ article/Harvey-Milk- 
Norwegian-dreamliner-1372 1891 . php  ,  operated  by  Norwegian 
Air  https://millsfield.sfomuseum.org/airlines/NRS/  : 


https  ://millsfield.sfomuseum  .org/airplanes/GCKWT  / 

You  can  see  all  the  individual  flights  for  an  airplane  or  the  airports  that  it  has 
traveled  to  or  arrived  from  (where  one  half  of  the  journey  is  SFO): 

https://millsfield.sfomuseum.org/airplanes/GCKWT/flights/ 

https://millsfield.sfomuseum.org/airplanes/N431UA/airports/ 

It's  also  possible  to  search  for  flights  by  their  tail  number: 

https :  //millsfield  .sfomuseum  .org/search/?  q=X  AKN  O 

You  can  see  flights  and  airports  for  individual  aircraft  models: 


https :  //millsfield. sfomuseum  .org/aircraft/B7 89/flights/ 
https://millsfield.sfomuseum.org/aircraft/A388/airports/ 


Airbus  A380-800  flights  in  and  out  of  SFO 

See  just  the  arrivals  or  only  the  departures  for  Airbus  A380-800  /  Or  see  all  the  airports  this  aircraft  has  flown  to  (from  SFO)  or  left 
from  (traveling  to  SFO) 


show  all  the  airports  for  these  flights 

AF83  (SFQ-CDGt  1377741435  (20190515-D-AFR-83) 

This  Air  France  flight  traveled  from  San  Francisco  International  Airport  to  Paris  Charles  de  Gaulle  Airport,  on  May  15,  2019.  It  departed 

from  gate  A5.  Passengers  on  this  flight  were  flying  aboard  an  Airbus  A380-800  with  tail  number  FHPJJ.  See  all  the  flights  for  AF83. 

LH455  (SFO-FRA)  1377741837  ( 201905 15-D-DLH-455) 

This  Lufthansa  flight  traveled  from  San  Francisco  International  Airport  to  Frankfurt-Hahn  Airport,  on  May  15,  2019.  Passengers  on  this 
flight  were  flying  aboard  an  Airbus  A380-800  with  tail  number  DAIMM.  See  all  the  flights  for  LH455. 

LH455  (SFQ-FRA)  1377700685  (20190514-D-DLH-455) 

This  Lufthansa  flight  traveled  from  San  Francisco  International  Airport  to  Frankfurt-Hahn  Airport,  on  May  14,  2019.  Passengers  on  this 
flight  were  flying  aboard  an  Airbus  A380-800  with  tail  number  DAIMK.  See  all  the  flights  for  LH455. 

LH455  (SFO-FRA)  1377663575  ( 20190511-D-DLH-455) 

This  Lufthansa  flight  traveled  from  San  Francisco  International  Airport  to  Frankfurt-Hahn  Airport,  on  May  11, 2019.  Passengers  on  this 
flight  were  flying  aboard  an  Airbus  A380-800  with  tail  number  DAIMI.  See  all  the  flights  for  LH455. 


Did  you  know  that 

Lufthansa  https : //mills field. sfomuseum.org/ airlines/ 1159284711/ 
operates  at  least  three  different 

A380S  https://millsfield.sfomuseum.org/aircraft/1159289437/  in 


and  out  of  SFO?  I  didn't.  Here  are  all  the  flights  for  all  the  different  737 

models  https : //mills field. sfomuseum.org/ aircraft/ 11592 898 19 /rela 
ted/  taking  off  and  landing  at  the  airport: 

https://millsfleld.sfomuseum.org/aircraft/1159289819/flights/ 


Aircraft  operated  by  Air  Canada  that  have  visited  SFO 

These  are  not  all  the  Air  Canada  aircraft  models  that  have  flown  in  or  out  of  SFO,  just  the  ones  we've  seen  since  we  so  far. 


This  map  does  not  depict  exactly  where  these  places  are  located  but  rather  an  approximation.  Think  of  it  as  being  more 
' around  here'  than  say  another  place  in  the  world. 

Airbus  A320-200  1159292085  (1237) 

This  aircraft  is  manufactured  by  Airbus.  We've  logged  64  flights  in  and  out  of  SFO  (since  we  started  counting). 

Airbus  A321  1159289411  (26) 

This  aircraft  is  manufactured  by  Airbus.  We've  logged  31  flights  in  and  out  of  SFO  (since  we  started  counting). 

Boeing  767-300  1159289965  (272) 

This  aircraft  is  manufactured  by  Boeing.  We've  logged  19  flights  in  and  out  of  SFO  (since  we  started  counting). 

Airbus  A31 9  1159289407  (24) 

This  aircraft  is  manufactured  by  Airbus.  We've  logged  17  flights  in  and  out  of  SFO  (since  we  started  counting). 

Boeing  777-200LR  1159289989  (283) 

This  aircraft  is  manufactured  by  Boeing.  We've  logged  2  flights  in  and  out  of  SFO  (since  we  started  counting). 


We  have  endpoints  for  the  individual  airplanes  and  aircraft  models  that  an 
airline  has  flown  in  and  out  of  SFO: 


https :  //millsfield  .sfomuseum  .org/air  lines/AC  A/airplanes/ 


https://millsfleld.sfomuseum.org/airlines/ACA/aircraft/ 


Or  the  different  aircraft  models  that  visited  a  particular  gate  at  the  airport: 

https://millsfield.sfomuseum.org/gates/G96/aircraft/ 

The  combinatorial  possibilities  for  slicing  and  dicing  all  this  data  are  as 
dizzying  as  they  are  exciting.  A  few  things  that  should  exist  but  don't,  yet, 
include: 


•  https:/ 7millsfield.sfomuseum.org/ gates/{  GATE_NUMBER }/airplanes/ 

•  https:/ lmillsfield.sfomuseum.org/ flights/{FLlGHT_NUMBER}/aircraft/ 

•  https  ://millsfield.sfomuseum.org/flights/{FLIGHT_NUMBER}/ airplanes/ 

We've  also  started  publishing  planned  flight  routes  and  the  actual  flight  path 
recorded,  when  that  data  is  available. 


Both  the  route  and  the  path  are  published  alongside  the  principal  flight  record  as 
"alternate "  geometries . 


P  sfomuseum-data/sfomuseum-data-flights-2019-05  ©  unwatch  -  i  ★star  o  VFork  o 


OCode  ©Issues  0  Pull  requests  0  iy  Projects  0  HI  Wiki  Insights  0  Settings 


Branch:  master  -  sfomuseum-data-flights-2019-05  /  data  / 137  /  774  /  096  /  7  /  1377740967-alt-swim-  Find  file  Copy  path 

route.geojson 

sfomuseumbot  append  SWIM  data  for  2019-05-15  5f4f 276  6  hours  ago 

0  contributors 


We've  talked  about  alternate 

geometries  https : //mills field. sfomuseum.org/blog/2019/ 01/14 / gates 
/  at  length,  in  the  past,  in  the  context  of  "where"  a  gate  is  located  at  the 
airport,  so  it's  like  that  but  for  flight  data! 


Flight  path  for  AS373  on  this  date 


Sometimes  flight  paths  may  look  a  bit  weird  in  places,  because  that  is  (can  be)  the  nature  of  radar  data.  It  should  still  give 
you  a  rough  idea  of  where  this  flight  traveled  to  and  from  though. 


As  of  this  writing  the  flight  paths  are  coarse  as  well  as  clipped  in  and  around 
airports  and  at  the  edges  of  the  United  States.  That's  not  ideal  and  we're  working 
on  getting  better  data.  Since  there  was  no  flight  path  data  available  a  couple  of 
weeks  ago  we  think  it's  a  good  start  and  qualifies  as  "better  than  yesterday". 


"Version  2" 


As  you  can  see  from  the  diagram  above  this  project  is  fully  "boxes  and  arrows" 
compliant.  The  bits  in  yellow  are  actual  code  that  we  write  ourselves  and 
everything  else  are  abstraction  layers  and  third-party  services  that  make  up 
"modern"  software  development  in  2019. 


The  un-numbered  boxes  at  the  top  are  the  data  sources  for  the  flight  data.  The 
un-numbered  boxes  at  the  bottom  are  this  website.  Boxes  1,  2  and  4  are  what 
we  started  with  back  in  January  when  we  began  publishing  flight 
data  https : //mills field. sfomuseum.org/blog/2019/ 01/18/ flights/ 

The  boxes  numbered  3  and  5  are  the  newer  tools  we  use  to  process  a  recent  data 
source  that  we  are  still  getting  familiar  with  and  where  all  this  new  data  comes 


from.  In  time  the  newer  data  consumers  (boxes  3  and  5)  may  become  the 
primary  source  for  all  things  flight-related  but  it's  early  days  still. 


We  are  trying  to  learn  by  doing  and  in  order  for  that  to  work  we  need  to  "do" 
things  in  small  steps,  in  a  way  that  doesn't  mean  tearing  everything  down  and 
starting  from  scratch  every  time  we  have  a  new  idea. 


We  need  to  make  "version  1"  simple  enough  to  launch  and  "version  2"  (and  3 
and  4  and  so  on)  simple  enough  to  make  revisiting  a  project  worthwhile  and, 
importantly,  simple  enough  that  it  doesn't  break  version  1 .  Sometimes  that  is 
easier  said  than  done  but  that's  the  work,  right? 

Box  6  is  the  openly  licensed  flight  data  that  we 

publish  https : / / github . com/ sf omuseum-data? 

utf 8=%E2% 9C% 93 &q=sf omuseum-data-f lights &type=&language=  every  day 

and  boxes  7  and  8  are  the  tools  that  we  use  to  wrangle  that  same  data  in  to  this 
website.  Everything  you  see  here  has  been  built  using  the  same  raw  materials 
that  we’ve  made  available  for  you  to  do  something  with. 


Earlier  this  year  I  attended  the  annual  Museums  and  the  Web 
conference  https://mwi9.mwconf.org  and  delivered  a 
talk  https : //www. aaronland. inf o/weblog/2019/04/08/post/#mwl9  to 
accompany  a  paper  about  the  work  we're  doing  with  the  Mills  Field 
Website  https : / /mwl9 .mwconf . or g /paper /mapping- space- time -and- the- 
coiiection-at-sf  o-museum/  .  I've  excerpted  one  part  of  the  talk  that  is 


relevant  here: 


export 

build 

publish 


Historically  the  model  for  most  digital  or  web-based  initiatives 
has  been  to  brst  export  data  from  an  internal  collections 
management  system.  Second,  that  data  is  massaged  in  to  an 
intermediate  form  for  use  by  the  project  at  hand  and  then  third, 
exported  again  in  to  a  typically  bespoke  machine-readable  format. 


export 

export 

build 

publish 

publish 

build 

We  have  changed  the  order  of  things  to  publish  the  open  data 
representation  first  and  then,  from  there,  to  build  our  own 
websites  and  services  on  top  of  that. 


Everything  I've  described  so  far  has  been  built  using  the  same  raw 
materials  that  we've  made  available  for  you  to  do  something  with. 
This  introduces  a  non-zero  cost  in  the  build  process  for  the 
public-facing  museum  efforts  but  we  believe  it's  worth  the  cost. 


But  why,  right? 


First  of  all  we  want  other  people  to  build  new  interfaces  and  new 
services,  new  "experiences"  even,  on  top  of  our  collection  so  this 
is  a  way  to  keep  ourselves  honest.  If  we  can't  build  something 
with  this  stuff  why  should  we  imagine  you  will  ? 


Second,  we  want  to  ensure  that  the  data  we  release  and  the 
manner  in  which  it  is  published,  is  actually  robust  and  flexible 
enough  to  engender  a  variety  of  interfaces  and  uses  because  we 
need  that  variety.  It  is  important  to  the  museum  because  I  don't 
believe  there  is,  or  should  be,  only  one  master  narrative  in  to  the 
collection. 


We  have  published  five  months  and  (counting  worth)  of  flight 

data  https : / / github . com/ sf omuseum-data?utf 8=%E2%9C%93&q=sf omuseum- 
data-f  light s&type=  so  far  and  while  that  data  may  not  seem  terribly 
exciting  on  any  given  day  its  value  grows  in  the  aggregate. 


There  are  stories  attached  to  every  one  of  those  flights  and  given  that  part  of  the 
museum's  mandate  is  the  history  of  the  airport  we  have  an  interest  in  crafting  a 
space,  a  dance  floor  even,  for  those  stories  to  strut  their  stuff.  There  are  also 
places  attached  to  each  flight  and  given  that  everything  we  collect  and  display  is 
also  from  somewhere  we  are  excited  to  use  any  given  flight,  to  and  from  SFO, 
as  an  avenue  in  to  our  collection. 


Meanwhile,  speaking  of  tail 

numbers  https : / /mills f ield. sf omuseum. org/ airplanes /N4 17UA/ f ligh 
ts/  ... 
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postcard:  Pan  American  World  Airways,  c.  1985,  Collection  ofSFO  Museum,  2012.149.0618 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //millsf ield. sfomuseum.org/blog/2019/ll/04/place 
holder  ,  in  November  2019. 


This  is  a  long  and  technical  blog  post.  The  short  version  is:  It  is  now  easy, 
possible  and  inexpensive  to  install  and  operate  a  " coarse "  geocoding 
service,  with  global  coverage,  support  for  multiple  languages  and  stable 
permanent  identifiers  using  openly  licensed  data,  both  locally  and  in  the 
cloud  .  We've  made  some  additional  tools  to  complement  this  reality  and 
waded  through  some  of  the  muck  of  modern  software  development  so  you 
don't  have  to. 


In  August  of  this  year,  the  nice  folks  at  Geocode 

Earth  https :  /  /geocode .  earth/  published  a  blog  post  titled  "An 

(almost)  one  line  coarse  geocoder  with 

Docker  https : //geocode . earth/blog/2  0 19 /almost-one-line-coarse- 
geocoding  " .  Geocoding  is  the  term  of  reference  to  describe  the  process  of 
converting  an  address  or  a  place  name  in  to  an  unambiguous  identifier, 
typically  latitude  and  longitude  coordinates. 

Stephen  Hess's  "Geocoding  for 

Polyglots  https : //www.mapzen . com/blog/geocoding-f or- 
poiygiots/  "  is  a  good  introduction  to  the  subject  if  you're  curious  to 
know  more  about  how  geocoding  works.  Stephen  and  the  Geocode  Earth 
team  all  worked  together  at  Mapzen  https :  /  /www .  mapzen .  com  on  the 
Pelias  https://www.peiias.io/  search  engine.  (I  also  worked  at 
Mapzen.) 


The  act  of  geocoding  is  further  distinguished  between  "street  level" 
geocoding  and  "coarse"  geocoding.  According  to  the  Geocode  Earth  blog 
post: 


A  coarse  geocoder  only  supports  cities,  countries  and  other 
administrative  areas,  so  it  includes  a  lot  less  data  than  a  full 
geocoder  with  addresses,  streets,  points  of  interest,  and  so  on. 


The  blog  post  goes  on  to  say: 


The  Placeholder  service  needs  data  in  order  to  run.  In 
particular,  it  expects  data  from  the  Who’s  on  First  gazetteer. 
The  Who’s  on  First  project  is  an  active,  growing  open-data 
project  that  was  started  along  with  Pelias  at  Mapzen.  ...  The 
Who’s  on  First  project  has  a  lot  of  great  properties:  stable 
identifiers,  very  high  quality  geometries,  excellent  structures 
for  handling  disputed  territories,  translations  in  multiple 
languages  including  official,  preferred,  and  colloquial 
variants,  and  much  more. 


Which  is  exciting  for  us  since  we  are  actively  using  Who's  On 
First  https://millsfield.sfomuseum.org/blog/tags/whosonfirst  in 
our  own  efforts.  We  are  making  "place"  the  joint  around  which  everything  in 
our  collection  pivots  but  a  lot  of  the  location  data  in  our  collection  (in  all 
collections!)  is  still  encoded  as  text  and  phrases  meant  for  humans.  "Words 
for  humans"  is  a  good  thing  but  the  opportunity  that  geocoding  affords  us  is 
the  ability  to  marry  words  for  humans  and  machines  both  (names  and  labels 
and  stable  permanent  unamibiguous  identifiers). 


For  example  there  are  70  other  places,  in  six  different  countries,  outside  of 
New  York  City  called  "Brooklyn".  The  city  of 

Monterey  https://spelunker.whosonfirst.org/id/85922611/  ,  in 
California,  can  also  be  referred  to  as  "dr  1/—"  in  Japanese  or  "iSjj |%*" 
in  Arabic.  Creating  stable  referents  for  the  many  ways  we  refer  to  the 
Same  thing  https : //whosonfirst.org/blog/2017/10/17/whosonfirst- 
nacis-2017/  is  exactly  what  the  Who's  On  First  project  is  for.  A 
geocoding  service  that  "speaks"  Who's  On  First,  that  will  return  a  stable 


permanent  identifier  with  each  search  result,  is  pretty  great  and  will  help  us 
to  improve  the  location  metadata  associated  with  our  collection  objects. 

In  addition  to  being  committed  to  open  source 

software  https: //geocode. earth/opensource  the  Geocode  Earth  team 
have  also  made  distributions  of  the  data  they  use  to  run  their  services 
available.  This  includes  data  used  by  the  Placeholder 
geocoder  https: //geocode,  earth/data  .  So,  the  gist  of  their  blog  post 
is  that  you  can  download  the  data  and  run  it  alongside  a  Docker-ized  version 
of  the  Placeholder  software  and  just  like  that  you  have  a  coarse  geocoder 
available  for  all  your  needs! 


postcard:  United  Air  Lines,  Douglas  DC-6,  c.  1949,  Collection  ofSFO  Museum,  2007 .108.001 


Did  you  notice  the  way  I  just  said  "Docker-ized"? 


Docker  https :  /  /www .  docker .  com/  is  both  a  service  and  an  application 
for  running  virtual  machines  which  are  referred  to  as  "containers".  A 
container  is  basically  a  freeze-dried  virtual  computer  that  contain  only  that 
which  is  absolutely  necessary  to  run  a  pre-dehned  set  of  applications.  Tools 
like  Docker  take  care  of  "thawing"  (and  re-freeze-drying)  containers  and 
running  the  software  they  contain.  It's  a  pretty  clever  abstraction  and 
managing  the  operation  of  containers,  as  a  service,  has  been  adopted  by  all 
the  different  cloud  providers . 

Since  you  can  also  run  Docker  on  your  local  machine  it  offers  the  ability  to 
work  with  all  kinds  of  applications  and  services  that  a  person  might  not 
otherwise  want  or  know  how  to  install,  including  a  tool  like  the  Placeholder 
geocoder  which  has  a  long  list  of  dependencies  it  needs  in  order  to  run. 


I  mention  all  of  this  because  after  reading  the  Geocode  Earth  blog  post  I 
thought:  We  should  set  up  an  instance  of  Placeholder  for  SFO  Museum. 
Although  the  Geocode  Earth  team  publish  an  official  Placeholder 
"container"  and  the  Placeholder  application  has  its  own  web  interface  we 
developed  our  own  versions  of  each.  They  are: 


https://github.com/sfomuseum/docker-placeholder 


This  is  SFO  Museum's  Dockerfile  for  running  the  (Pelias) 
Placeholder  service.  This  creates  a  container  image  with  the 
Placeholder  software  and  the  SQLite  database  it  uses  stored 
locally  (to  the  container).  That  means  it  creates  a  container 
image  that  is  very  very  big.  This  may  not  be  the  container 
image  you  want  to  use.  We  may  not  use  it,  in  time. 


And: 


https://github.com/sfomuseum/go-placeholder-client-www 


This  is  a  Go  package  that  provides  a  simple  web  application 
for  querying  a  (Pelias) 

Placeholder  https : //github. com/pelias/placeholder 
server  and  uses  Bootstrap  https://getbootstrap.com/  , 
Leaflet  https://leafletjs.com/  , 

Tangram  https://github.com/tangrams/tangram  and 
Nextzen  https://www.nextzen.org/  tiles  to  render  pages 
and  maps.  All  (JavaScript  and  CSS)  assets  are  bundled 
locally  with  the  application  and  it  is  possible  to  configure  the 
application  to  serve  and  cache  local  copies  of  Nextzen  tiles. 


There  is  also  a  separate  package  for  talking  directly  to  the  Placeholder 
service  programatically  that  is  used  by  the  go-placeholder-client - 
www  tool: 


https://github.com/sfomuseum/go-placeholder-client 


Once  everything  is  installed  and  running  it  looks  like  this: 


Placeholder  br00klyn 


Query  results  for  "brooklyn" 

There  are  71  places  matching  this  query 


18 

<S 

404495141 

Brooklyn 

localadmin 

Wisconsin 

United 

States 

42.813213 

-89.429353 

19 

<1 

85931311 

Brooklyn 

locality 

Connecticut 

United 

States 

41.789932 

-71.952759 

20 

<¥ 

404487255 

Brooklyn 

Township 

localadmin 

Pennsylvania 

United 

States 

41.75916 

-75.800937 

21 

<S 

404491661 

Brooklyn 

localadmin 

Wisconsin 

United 

States 

42.855943 

-89.365521 

The  Brooklyn  that  most  people  think 

of  https://spelunker.whosonfirst.org/id/421205765/  in  New  York 
City  (not  shown)  has  ID  421205765  to  distinguish  it  from  the  Brooklyn 
in  Connecticut  https : //spelunker . whosonf irst . or g/id/4 04495913/ 
with  ID  404495913,  and  so  on. 


Did  we  mention  "support  for  not-English  languages"  ?  For  example  if  I 
query  for  http :  / /localhost :  8080?text=(;5j._^LJ j_o  the  results  look 
like  this: 


Did  you  notice  something  about  the  go-placeholder-client-www 
tool?  It's  a  relatively  simple  web  application  that  depends  on  three  separate 
JavaScript  frameworks,  two  different  services  and  a  whole  other  cartography 
component.  They  are: 


•  Placeholder  https://github.com/pelias/placeholder  — 
The  coarse  geocoder  we've  been  discussing  so  far. 

•  Bootstrap  https://getbootstrap.com/  —  A  framework  for 
developing  responsive  and  mobile  websites. 

•  Leaflet  https://ieafietjs.com/  -  A framework  for  web- 
based  mapping  applications . 

•  Tangram  https://github.com/tangrams/tangram  —A 
framework  for  styling  and  rendering  data  in  web-based 
mapping  applications . 

•  Nextzen  https :  //www.  nextzen .  org/  —  A  free  and  open 
provider  of  geographic  data  for  web-based  mapping 
applications. 

•  Tangram  map  Styles  https://github.com/tangrams? 

utf  8=%E2%9c%93&q=-styie  -  The  cartography  and  styles 

used  by  Tangram  to  render  data  provided  by  Nextzen .  These  are 
also  referred  to  as  "scene  files" . 

Like  Pelias  and  Who's  On  First  both 

Tangram  https://www.mapzen.com/tag/tangram/  and  Nextzen  (then 
known  as  Tilezen  https://www.mapzen.com/tag/tiies/  )  began  life  at 
Mapzen . 

For  most  of  the  last  decade  the  conventional  wisdom  has  been  to  load  each 
of  these  pieces  remotely.  Usually  these  pieces  are  hosted  by  some  sort  of 


third-party  content  distribution  network  (or  CDN)  to  help  speed  things  up 
and  the  guts  of  an  application  are  often  little  more  than  the  glue  that  binds 
all  these  remote  bits  of  functionality  together.  It's  a  fine  way  of  doing  things 
but  it's  not  the  way  that  I  wanted  to  set  up  a  Placeholder  service  for  the 
museum. 


Instead  I  wanted: 

1.  To  run  a  local  copy  of  Placeholder. 

2.  For  all  of  the  Javascript  dependencies  (Bootstrap,  Leaflet, 
Tangram)  to  be  bundled  with  the  application  and  served 
locally. 

3.  To  be  able  to  read  and  write  cached  tiles  from  Nextzen. 

4.  To  be  able  to  do  all  of  this  both  locally,  on  a  remote  server  and 
in  the  cloud 


We  did  things  this  way  because  each  of  the  six  dependencies  listed  above 
are  important  pieces  of  the  application  we've  developed.  Some  are  less 
critical  than  others  in  that  they  could  be  replaced,  relatively  easily,  with  an 
alternative  should  the  need  arise  but...  you  know,  we're  busy  running  a 
museum. 


So,  the  docker-placeholder  Dockerfile  accomplishes  #1  (and  #4)  : 

$>  docker  run  -it  -p  3000:3000  placeholder  npm  start  — prefix  /usr/local/pelias/placeholder 


>  pelias-placeholder@0 . 0 . 0-development  start  /usr/local/pelias/placeholder 


>  . /cmd/server . sh 


2019-11-01T2 1:53:22. 201Z 
2019-11-01T2 1:53:22. 250Z 
2019-11-01T2 1:53:22. 251Z 
2019-11-01T2 1:53:22. 807Z 
2019-11-01T2 1:53:22. 808Z 


info:  [placeholder]  [master]  using  2  cpus 

info:  [placeholder]  [master]  worker  forked  24 

info:  [placeholder]  [master]  worker  forked  25 

info:  [placeholder]  [worker  24]  listening  on  0.0.0.0:3000 

info:  [placeholder]  [worker  25]  listening  on  0.0.0.0:3000 


The  go-placeholder-client -www  package  does  #2  through  #4: 


$>  go  run  -mod  vendor  cmd/server /main. go  \ 

-nextzen-apikey  {NEXTZEN_APIKEY}  \ 

-proxy-tiles  \ 

-proxy-tiles-dsn  'cache=blob  blob=f ile : ///tmp/nextzen ' 
2019/11/01  14:44:52  Listening  on  http: //localhost: 8080 


The  important  part  here  is  that  everything  is  bundled  in  to  a  single 
application,  not  that  there  aren't  other  equally  valid  ways  of  doing  the  same 
thing. 


Once  it's  all  up  and  running  when  I  visit  http :  /  /localhost :  8080/? 
text=san+diego  in  my  web  browser  I  see  this: 


<-  >  C?  0  ©  localhost:8080/?text=san+: 

Placeholder 

Query  results  for  "san  diego" 

There  are  100  places  matching  this  query 


©  &  Q,  Search 


±  m\  cd  0  «  ©  s  g 

san  diego  Search 


ID 

Name 

Placetype 

Region 

Country 

Latitude 

Longitude 

1 

© 

102083569 

San  Diego 
County 

county 

California 

United 

States 

32.995842 

-116.77015 

2 

© 

85922227 

San  Diego 

locality 

California 

United 

States 

32.72793 

-117.15529 

3 

© 

421180477 

San  Diego 

county 

Carabobo 

Venezuela 

10.272851 

-67.95913! 

G?  O  Inspector 
©  V  Filter  URLs 

St...  M...  Domain 

fra  GET  A 
ED  GET  A 
FTTtl  GET  A 
ED  GET  A 
ED  GET  A 


ffl  —  X 

WS  Other  ~  Persist  Logs  —  Disable  cache  No  throttling  t  HAR  i 
Cache  Timings  Stack  Tra  ▼ 


EE)  GET 


ED  GET 

ED  get 


I  GET  Aloca 


ED  GET  Alo 
ED  GET  Alo 
fH1  GET  Alo 
ED  GET  Alo 
ED  GET  A  lo 
ED  GET  Alo 


171  Console  D  Debugger  {}  Style  Editor  O  Performance  O  Memory  Network  "fp  Accessibility  » 
I  I  All  HTML  CSS  JS  XHR  Fonts  Images 


leaflet-hash.js 

tangram.min.js 


0.mvt?api_key=pChNAqlOQf...  xhr 
0.mvt?api_key=pChNAqlOOf...  xhr 
1.mvt?apLkey=pChNAqlOOf...  xhr 
1.mvt?api_key=pChNAqlOQf...  xhr 
51.mvt?api_key=pChNAqlOQ...  xhr 
51.mvt?apLkey=pChNAqlOQ...  xhr 
51.mvt?apLkey=pChNAqlOQ...  xhr 

4.62  MB  /  2.16  MB  transferred 


If  you  look  closely  images/placeholder-sandiego.png  at  the 
screenshot  you  can  see  that  the  only  thing  that  is  loaded  remotely  over  the 
network  is  the  Who's  On  First  https://www.whosonfirst.org  gazetteer 


record  for  San 

DiegO  https://spelunker.whosonfirst.org/id/85922227/  .  It  is 
possible  to  set  up  a  local  copy  ofWOF  data  files  but  we  haven't  yet. 


In  the  example  above  we've  passed  a  -proxy-tiles  flag  which  is  a 
signal  to  the  server  tool  to  cache  and  re-use  Nextzen  tiles  locally.  Under 
the  hood  the  caching  mechanism  is  using  the  Go  Cloud  "blob" 
abstraction  https://gocioud.dev/howto/biob/  for  data  storage. 


>  find  /tmp/nextzen  -name  '*.mvt'  -print 
/tmp/nextzen/7/21/51 .mvt 
/tmp/nextzen/7/23/51 .mvt 
/tmp/nextzen/7/22/51 .mvt 
/tmp/nextzen/1/0/0 .mvt 
/tmp/nextzen/1/0/1 .mvt 
/tmp/nextzen/1/1/0 .mvt 
/ tmp/next zen/1/1/ 1 .mvt 

In  these  examples,  we  are  using  the  local  filesystem  but  the  Go  Cloud  layer 
allows  us  to  swap  that  out  for  a  number  of  other  sources  and 
Services  https ://gocloud.dev/howto/blob/#services  with  a 
minimum  of  fuss.  That's  important  because  we  want  to  able  to  host  the  go- 
placeholder-client  -www  server  using  Amazon  Web  Services  (AWS) 
and  cache  Nextzen  tiles  in  an  S3  bucket. 


The  good  news  is:  It  works  and  the  few  remaining  "gotchas"  are  minor  to 
the  point  of  being  insignificant  or  pedantic.  The  bad  news  is:  The  bad  news 
isn't  so  bad  now  that  we've  mostly  figured  things  out  and  you  don't  have  to. 
So,  it's  kind  of  good  news  with  the  lesson  being  that  the  cloud  is 
never  as  easy  as  anyone  says  it  is. 


Some  of  the  issues  we've  encountered  along  the  way  might  have  been  easily 
remedied  if  we  chose  to  "go  all  in"  with  AWS  (or  any  other  cloud 


provider)  so  it's  imporant  to  state  up  front:  We  aren't  willing  to  do  that. 
Additionally  I  don't  believe  an  "all  in"  approach  with  cloud  services 
benefits  the  cultural  heritage  sector  in  the  long  term. 


There’s  a  longer  discussion  that  needs  to  be  had  sector-wide  about  the  how 
and  why  this  is  the  case  but  it  can  largely  be  summed  up  as  "vendor  lock-in" 
and  the  inability  of  an  institution  to  wiggle  free  of  vendor  lock-in  once  it 
happens.  Our  goal  is  to  understand  the  ways  we  need  develop  and  deploy 
the  technical  scaffolding  to  service  our  specific  efforts  without  letting  the 
nuances  of  any  given  service  provider  become  a  finger  trap. 

As  such  there's  a  lot  of  effort  to  recognize  and  enforce  "layers  of 
separation"  that  incur  a  non-zero  cost  in  the  short-term  but  that  we 
believe  will  be  worth  it  over  the  long-term. 

The  first  "just  get  it  to  work"  architecture,  for  running  Placeholder  and  the 
Placeholder  client  in  AWS,  looked  like  this: 


Warning:  There  is  a  small  hurricane  of  AWS -related  product  names  that 
follows.  If  you  don't  know  what  a  particular  term  means  they  are  all  easily 
findable  and  well-documented  online. 


This  setup  runs  the  server  tool  as  a  Lambda  function  fronted  by  an  API 
Gateway  that  is,  in  turn,  fronted  by  a  CloudFront  distribution.  The 
Placeholder  service  itself  is  deployed  as  a  long-running  server  using  the 
Fargate  ECS  service  (to  run  the  docker-placeholder  container). 


The  problem  with  this  setup  is  that  pending  patches  to  the  way  that  Tangram 
loads  scene  files,  there  is  no  way  to  tell  API  Gateway  to  send  those  map 
styles  (which  are  bundled  in  to  the  go-placeholder-client-www 


tool)  as  binary  data  instead  of  as  Base64  encoded 

String  https://en.wikipedia.org/wiki/Base64  .  All  of  which  makes 
Tangram  very  confused  causing  it  not  render  any  data  at  all. 


The  only  option  here  is  to  load  scene  files  hosted  on  the  Nextzen  website.  To 
be  clear:  Having  to  fetch  the  scene  files  remotely  is  not  the  end  of  the  world 
but  since  the  exercise  is  to  try  and  set  things  up  so  that  they  are  completely 
self-contained  it's  not  ideal. 


The  second,  more  recent,  architecture  looks  like  this  and  illustrates  all  the 
various  components  in  a  little  more  detail  (you  can  see  a  full-size  version 
here  images/arch-f argate.jpg  ): 
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Note:  There  should  be  an  additional  box  labeled  go-http-bootstrap 
in  the  diagram  above  but  you  can  still  get  a  sense  of  the  many  different 
pieces  of  functionality  all  interacting  with  one  another  to  produce  a 
"simple"  web  application. 


This  setup  runs  the  server  as  a  long-running  process  in  an  ECS  (Fargate) 
container,  fronted  by  a  CloudFront  distribution.  This  means  there  are  no 
problems  involving  response  encodings  and  the  "bundled"  scene  files  can  be 
loaded  and  rendered  by  Tangram  without  any  issues. 


The  problem  with  this  approach  is  that  in  order  to  fetch  Nextzen  tiles  from 
their  source  (out  there  on  the  internet)  and  cache  them  to  an  S3  bucket 
(internally  on  the  AWS  network)  you  need  to  enable  some  non-trivial  AWS 
networking  configurations.  It's  possible  but  it  requires  a  lot  of  button¬ 
pressing  and  I  just  haven't  figured  it  all  out  yet. 


There  are  good  reasons  why  this  scenario  is  more  complicated  than  you 
might  think  it  needs  to  be.  Networking  is  a  complicated  beast,  especially  so 
in  the  age  of  actively  bad  actors  that  we  are  living  through,  so  I  would  prefer 
that  AWS  be  more  conservative  than  not  about  these  things.  At  the  same  it's 
also  a  good  example  of  the  truism  that  in  order  to  do  simple  things  in  the 
cloud  it  usually  involves  signing  up  for  two  or  three  more  cloud 
services. 

That’s  as  far  as  we've  gotten  to  date.  Our  Placeholder  endpoint  isn't  available 
for  use  by  the  general  public,  at  least  not  yet,  but  we  have  made  all  of  the 
software  available  on  GitHub  https://github.com/sfomuseum  for  you 
to  set  up  your  own  instance.  We've  already  identified  a  series  of 


Outstanding  UI  and  UX  issues  https  :  //github.com/sfomuseum/go- 
piacehoider-ciient-www/issues  so  if  you'd  like  to  lend  a  hand  that 
would  be  a  good  place  to  start. 


Installation  view  of  "Building  for  Air  Travel",  SFO  Museum,  1997 


We  would  like  to  think  this  is  an  important  contribution  to  the  cultural 
heritage  sector  which  has  often  not  had  the  means,  whether  it  be  financial  or 
staffing,  to  tackle  the  problem  of  geocoding. 


This  post  started  by  saying  that  it  is  "now  easy,  possible  and  inexpensive  to 
install  and  operate  a  coarse  geocoding  service,  with  global  coverage,  support 
for  multiple  languages  and  stable  permanent  identifiers  using  openly 
licensed  data"  which  is  important  because  all  museum  collections  are 


ultimately  rooted  in  place.  Tools  like  Placeholder  and  openly  licensed  data 
like  Who's  On  First  https://www.whosonfirst.org/  make  it  possible 
for  museums  and  libraries  and  archives  to  adopt  a  common,  yet  flexible, 
notion  of  place  with  which  all  our  collections  might  hold  hands . 


2019-11-04 
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More  recent  old  maps  (and  the  shapes  in  the... 


More  recent  old  maps  (and  the 
shapes  in  the  details) 


https://millsfield.sfomuseum.Org/map#201 3/1 7/37.61 251/-1 22.35490 

2013  0 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //millsf ield. sfomuseum.org/blog/2019/ll/06/maps 
in  November  2019. 


We  recently  updated  the  Mills  Field  website  to  include  new  historic  aerial 
maps  https://millsfield.sfomuseum.org/map  from  2010  through 
2018. 


For  example,  here  is  Terminal  2  (T2)  being  renovated  in 

2010  https  :  /  /mills field. sfomuseum.org/map/#2010/17/37 .61790/-12 
2.38171  .  It's  sometimes  hard  to  grasp  just  how  big  modern  airplanes  are 


but  you  can  start  to  see  their  scale  next  to  a  parking  lot  full  of  regular-sized 
cars. 


T2  re-opened  the  following  year,  in  2011 .  Two  years  ago,  in  2017,  you  can 

see  the  outline  of  the  new  Terminal  1  (Tl)  taking 

shape  https : //mil Is field . sf omuseum. org/map/#20 10/ 17 /37 .61790/-1 


22.38171  .  The  new  T 1  re-opened  last  summer.  A  few  months  later  T 1 
looks  like  this: 


From  2017  onwards,  the  new  aerial  maps  are  incredibly  detailed. 


The  scale  of  most  web-based  mapping  projects  is  measured  using  "zoom" 
levels.  The  documentation  for  leaflet .  j  s,  a  popular  framework  for 
web-based  mapping  applications,  describes  zoom  levels  this 

Way  https://leafletjs.com/examples/zoom-levels/  : 


Let’s  just  assume  that  the  world  is  a  square.  When  we 
represent  the  world  at  zoom  level  zero,  it’s  256  pixels  wide 
and  high.  When  we  go  into  zoom  level  one,  it  doubles  its 
width  and  height,  and  can  be  represented  by  four  256-pixel- 
by-256-pixel  images.  At  each  zoom  level,  each  tile  is  divided 
in  four,  and  its  size  (length  of  the  edge,  given  by  the  tileSize 
option)  doubles,  quadrupling  the  area.  This  goes  on  and  on. 
Most  tile  services  offer  tiles  up  to  zoom  level  18,  depending 
on  their  coverage.  This  is  enough  to  see  a  few  city  blocks  per 
tile. 


Our  most  recent  maps  go  all  way  down  to  zoom  level 

20  https  : //wiki  .  openstreetmap .  org/wiki/Zoom_levels  .  The  detail  is 
pretty  amazing: 


►  mills  field 
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Mysterious,  even: 


Wandering  around  the  airport  at  high  zoom  levels,  seeing  the  "shape"  of 
airport  in  its  details,  is  so  much  fun  we've  added  a  handy  i£i  button  to  the 
map  that  will  allow  you  to  create  an  image  of  whatever  you  happen  to  be 
looking  at: 


Clicking  the  button  will  start  an  in-browser  process  to  copy  all  the  visible 
pixels  in  the  map  view  in  to  a  new  image.  This  process  takes  about  5-10 
seconds  and  once  it's  complete  triggers  an  operating  system  dialog  to  save 
the  file  to  your  computer  (or  open  it  for  viewing  in  another  application) . 


https://millsfield.sfomuseum.Org/map/#2014/17/37.61479/-122.37480 

2014  0 


This  works  for  both  the  aerial  imagery  and  the  base  tiles.  Here's  an  example 
screengrab  from 

1941  https : //mills field . sf omuseum. org/map/#l 94 1/bg/ 15/37 .6200/- 


122.3851 


All  of  this  work  has  meant  updating  the  base  tiles,  the  simplified  black  and 
white 

Cartography  https : //millsfield. sfomuseum.org/blog/2018/07/31/ 
maps/  that  we  use  for  maps  of  contemporary  SFO  and  the  rest  of  the 
world. 


It  was  time  to  update  the  tiles  anyway,  to  reflect  the  literal  changes  "on  the 
ground"  to  T1 ,  and  it  was  also  an  opportunity  to  make  some  much-needed 
updates  to  go-rasterzen  https://github.com/whosonfirst/go- 
rasterzen/  the  software  we  use  to  produce  the  base  tiles.  Those  changes 
include: 

Support  for  "over-zooming" 

go-rasterzen  renders  "data"  or  "vector"  tiles  produced  by 
Nextzen  https :  //nextzen .  org  which  stop  at  zoom  level  16.  All  of  the 
data  for  zoom  levels  17  and  higher  is  contained  in  the  zoom  16  tiles  so  it  is 
left  up  to  applications  consuming  the  Nextzen  tiles  to  crop  those  tiles  as 
necessary.  This  is  sometimes  referred  to  as  "over-zooming"  and  now  it's 
something  that  go-rasterzen  supports. 

Better  tile  seeding 

The  entire  world  rendered  at  zoom  level  20  produces  1 ,099,511 ,627,776 
tiles.  We  don't  render  the  whole  world  at  zoom  level  20  (or  even  17)  but  the 
number  of  tiles  covering  even  just  for  the  area  around  SFO  it  starts  to  add  up 
quickly.  We  used  to  keep  the  list  of  tiles  to  pre-seed  in  memory  but  that’s 
been  replaced  by  a  generic  catalog 

interface  https : //github . com/whosonf irst/go-rasterzen#seed- 


tile  set-catalog-dsn  with  support  for  a  local  SQLite  database  in 
addition  an  in-memory  structure. 


Admittedly,  this  is  a  necessary  but  not  very  exciting  change. 

Bug  fixes 

Most  importantly  we  fixed  a  bug  where  we  were  incorrectly  calculating 
dimensions  when  drawing  geographies,  converting  them  from  a  geographic 
coordinate  space  to  a  pixels  in  a  viewport  (or  tile).  This  would  happen 
infrequently  enough  before  we  had  to  render  tiles  at  high  zoom  levels  that 
figuring  out  what  was  going  on  never  managed  to  become  the  priority. 
Adding  support  for  over-zooming  quickly  forced  the  issue: 


The  problem  was  simply  that  we  were  doing  the  math  wrong.  We  assumed, 
incorrectly,  that  the  extent  of  the  geographies  contained  in  a  tile  would 
always  equal  or  exceed  the  edges  of  the  tile.  That  is  not  the  case. 


It's  a  little  hard  to  see  in  this  screenshot  because  it  doesn't  show  the  whole 
tile  that  was  rendered  incorrectly,  specifically  the  part  that  triggered  the 
problem.  It's  pretty  clear  that  the  countries  depicted  span  the  boundaries  of 
the  y  axis.  What  you  can't  see  is  that  they  don't  do  the  same  on  the  x  axis. 


We  were  calculating  the  geographic  boundaries  of  the  tile  based  the  edges  of 
countries  and  continents  rather  than  the  tile  itself  so,  unsurprisingly, 
everything  was  drawn  askew. 


Oops. 


Support  for  query-based  styles 

Styling  go-rasterzen  tiles  has  always  been  limited  to  stroke  and  fill 
colours,  widths  and  opacities.  That  hasn't  changed  but  it's  now  possible  to 
override  default  styles  using  an  equally-limited  query -based  syntax.  For 
example  the  follow  styles  definition: 


{ 

"tile_size" :  512.0, 

"stroke":  "#515151", 

" stroke_width" :  1.0, 

" stroke_opacity " :  1.0, 

"fill":  "#000000", 

" f ill_opacity" :  0.0, 

"styles":  { 

" geometry . type= [ Polygon , MultiPolygon ]  properties . kind= [ ocean , water , lake ] " : { 
"stroke":  "#515151", 

"stroke_width" :  1.0, 

"stroke_opacity" :  1.0, 

"fill":  "#000000", 

"f ill_opacity" :  0.2 

} , 

" properties . landuse_kind= [ apron , aerodrome ] " :  { 

"stroke" : "#ffffff " , 

" stroke_width " :  1.0, 

" stroke_opacity " :  1.0, 

"fill":  "#f 11499" 

"f ill_opacity" :  0.0 

}, 

" geometry . type= [ Polygon , MultiPolygon ]  properties . landuse_kind= [ apron , aerodrome ] " : 
"stroke" : "#ffffff " , 

"stroke_width" :  1.0, 

"stroke_opacity" :  1.0, 

"fill":  "#f 11499 " , 

"f ill_opacity" :  0.2 

> 

> 

> 


Produces  tiles  that  look  like  this: 


By  default  everything  is  rendered  grey-on-grey  but  the  SFO  campus  -  things 
whose  landuse_kind  property  is  either  apron  or  aerodrome  -  is 
rendered  as  white  with  semi-transparent  pink  fill. 


Branch:  master  -  sfomuseum-data-maps  /  data  / 147  /  788  / 175  /  9  /  1477881759.geojson  Find  file  Copy  path 


We've  also  made  sure  that  all  the  map  tiles  have  been  clipped  to  the  aerial 
imagery  itself  rather  than  the  extent  of  the  area  depicted,  which  would  result 
in  ugly  opaque  borders .  We  continue  to  treat  aerial  maps  themselves  as 
Who’s  On  First  (GeoJSON)  records: 

https  ://github  .com/sfomuseum-data/sfomuseum-data-maps 

By  using  GeoJSON  we  are  able  to  define  a  mask  for  clipping  imagery  and 
derive  its  extent  in  one  handy  file,  that  is  compatible  with  all  the  geo¬ 
processing  tools.  Other  map-related  properties  include 
(EDTF  https : //www. loc . gov/standards/datetime/  )  dates: 


"edtf : cessation" : "1956-09-08", 
"edtf : inception" : " 1956-09-08" , 


Zoom  levels: 


"mz: max_z  oom " : 1 6 , 
"mz :min_zoom" : 11 , 

Attributions: 


"src : geom" : "ucsblib" , 

"ucsblib: id" : "gs-vlx_l-61" , 

What  the  map  depicts,  for  example  SFO  the 

airport  https : //mills field . sfomuseum.org/airports/102527513/ 

and  SFO  the  terminal 

Complex  https : //millsf ield. sfomuseum.org/buildings/1159396329 

/  in  1956: 

"wof : depicts" : [ 

102527513, 

1159396329 

]r 

All  of  which  has  the  side-effect  of  these  records  serving  as  a  de  facto  map 
catalog.  That's  not  the  end  goal  here  (there  are  lots  very  good  pre-existing 
projects  like  the  StaioTemporal  Asset  Catalog  https :  //stacspec . org/ 
but  it's  always  fun  to  see  where  these  things  overlap. 


In  the  meantime,  all  the  new  maps  are  available  for  browsing  here: 

https://millsfield.sfomuseum.org/map 


Enjoy ! 


2019-11-06 
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museum  #computer-feelings  network  2019 


museum  #computer-feelings 
network  201 9 


I  attended  the  Museum  Computer  Network 

conference  http://mcn.edu/2019/  in  San  Diego  last  week. 

These  are  some  of  the  drawings  I  made  while  I  was  there. 


Day  1 


Day  2 


Day  3 
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This  is  obviously  not  a  drawing  but  the  photo  of  the  room  service 
tray  was  taken  at  the  MCN  conference  hotel.  The  photo  of  Little 
Baby  Bird-Crushing  Jesus  was,  coincindentally,  taken  at  the  Isabella 
Stewart  Gardner  Museum  just  before  this  year's  Museums  and  the 
Web  https : / /www. aaronland. info/weblog/2019/ 04/08/post 
conference  in  Boston.  The  screenshot  above,  courtesy  of  my  phone, 
largely  encapsulates  how  I  feel  about  the  tenor  and  the  substance  of 
the  discussion  surrounding  artificial  intelligence,  machine-learning 
and  the  cultural  heritage  sector  in  2019. 


2019-11-09 


cenas  do  capitalismo  tardio 


Postcards  of  Portugal 


Postcards  of  Portugal 


We  went  to  Portugal  earlier  this  fall.  These  are  some  of  the  postcards 
I  made  and  sent  to  people  along  the  way. 


Vila  Nova  de  Milfontes 


On  the  road 


Faro 


On  the  road  again 


Evora 


Lisbon 


Tourism  in  Lisbon  in  2019  is  bonkers  in  a  way  that  makes  it  easy  to 
be  critical.  I  had  the  opportunity  to  visit  Lisbon  in  2010  and  again  in 
2011  at  what  felt  like  the  bottom,  or  near  the  bottom,  of  the  U-curve 
that  followed  the  economic  bust  of  2008.  It's  not  like  there  were 
tumbleweeds  in  the  streets,  or  that  no  one  smiled,  but  it  was  clear 
people  were  hurting.  I  find  many  aspects  of  Lisbon  in  2019  to  be 
unpleasant  but  ten  years  ago  there  was  such  a  tangible  unhappiness 
hanging  in  the  air  that  it  is  difficult  for  me  to  want  to  deny  today's 


city  some  measure  of  the  good  times,  complicated  as  they  may  be 
these  days. 


2019-11-11 
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go-iiif  version  2.0 


go-iiif  version  2.0 


negative:  San  Francisco  International  Airport  (SFO),  TWA  ( Trans  World  Airlines),  Boeing  B-131, 1962,  Collection  ofSFO  Museum, 

2011.032.0732 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //mil Is field. sfomuseum.org/blog/2  019/ll/13/ iiif-v2  ,  in 

November  2019. 


Today,  I  am  happy  to  announce  that  go-iiif  https :  //github.com/go-iiif/go- 
iiif  version  2.0.0  has  been  released.  A  quick  refresher: 

II  IF  is  an  acronym  for  the  International  Image  Interoperability 
Framework  http  ://iiif.io/  ,a  project  driven  by  public  institutions  and 
private  companies  in  the  cultural  heritage  sector  to  produce  common  standards  and 
interfaces  (APIs)  for  accessing  and  working  with  collections  material. 


go-iiif  https://github.com/go-iiif/go-iiif  is  software  written  in  the  Go 
programming  language  https://goiang.org  that  implements  the  IIIF  Image 
API  http://iiif.io/api/image/  and  that  SFO  Museum  has  been  using  to 
process  the  images  in  its  collection.  We've  written  about  IIIF  before  in  the  following 
blog  posts: 

•  Using  IIIF  at  SFO 

Museum  https : //mills field. sfomuseum. org/blog/2 0 18/07/ 18/ i 
iif  / 

.  Using  IIIF  (with  AWS)  at  SFO 

Museum  https : //mills field. sfomuseum. org/blog/2 0 19/02 / 12/ i 
iif-aws/ 


The  biggest  change  in  the  2.0  release  is  that  go-iiif  no  longer  requires  the 
libvips  https://github.com/jcupitt/iibvips  image  processing  library,  by 
default,  libvips  is  pretty  great,  and  recently  added  the  ability  to  generate  IIIF- 
compatible  tilesets 

natively  https://github.com/libvips/libvips/issues/1465  , but  it 
introduces  non-trivial  build  and  setup  requirements.  It  is  still  possible  to  use  go- 
iiif  with  libvips  but  that  functionality  has  been  moved  in  to  a  separate 
package  https://github.com/go-iiif/go-iiif-vips  . 

As  of  version  2.0  go-iiif  does  all  its  image  processing  using  native  (Go)  code. 
Specifically,  Anthony  Simon's  bild  https  :  //github.com/anthonynsimon/bild 
for  most  image -related  tasks  and  Christian  Muehlhaeuser's 
smartcrop  https://github.com/muesii/smartcrop  for  cropping  images 
dynamically. 


The  absence  of  external  dependencies  means  that  go-iiif  tools  can  be  compiled 
in  to  standalone  applications  that  can  be  run  even  if  Go  isn't  installed  on  the  same 


computer.  This  allows  us  to  build  and  distribute  sophisticated  image  processing 
tools  to  staff,  tailored  to  our  workflow,  quickly  and  easily.  As  I  write  this  all  these 
tools  are  run  still  from  the  command-line  so  there  are  plenty  of  user  interface  and 
user  experience  improvements  that  remain  but  this  release  lays  the  foundation  for 
that  work  going  forward. 


go-iiif  tools  can  now  also  be  run  as  an  AWS  Lambda  functions.  Recently  we've 
been  using  AWS  ECS  instances  to  process  images  using  go- 

iiif  https : //mi 11s field. sfomuseum. org/blog/20 19/02 / 12 / iiif-aws/ 

That  works  fine  but  due  to  the  limit  on  the  number  of  concurrent  ECS  instances  that 
can  be  running,  and  the  corresponding  complexity  involved  in  scheduling  processes 
manually,  the  ability  to  use  Lambda  with  its  more  generous  limits  is  very  attractive. 


Other  notable  changes  from  previous  releases  are:  The  use  of  the  Go 

Cloud  https :  / / gocioud .  dev/  Bucket  and  Blob  interfaces  for  reading  and 

writing  files  to  a  variety  of  storage  endpoints  and  the  introduction  of  go-iiif- 

uri  https://github.com/go-iiif/go-iiif-uri  URI  strings  to  identify  images 

for  processing. 

The  rest  of  this  blog  post  is  very  technical  so  if  that's  not  of  interest  you  can  stop 
here.  It  is  divided  in  to  four  sections:  Drivers  #drivers  ,  Buckets  #buckets  , 
URIs  #uris  and  Tools  #toois  . 


Drivers 


photograph:  San  Francisco  Bay  Area,  two  men  in  grounded  biplane,  c.  1920,  Collection  ofSFO  Museum,  2010.174235 


All  image  processing,  including  the  native  Go  code,  is  done  through  the  use  of 
"drivers" ,  similar  to  the  way  the  Go 

database/sql  https://golang.org/pkg/database/sql/  packages  work.  A 
driver  needs  to  support  the  driver .  Driver  interface  which  looks  like  this: 

import  ( 

iiif cache  "github.com/go-iiif/go-iiif/cache" 
iiif conf ig  " github . com/ go-iiif / go-iiif /conf ig" 
iiif source  "github.com/go-iiif/go-iiif/source" 

) 

type  Driver  interface  { 

NewImageFromConf igWithSource ( *iiif conf ig. Conf ig,  iiif source. Source,  string)  ( iiif image . Image 
NewImageFromConf igWithCache ( *iiifconf ig.Conf ig,  iiifcache. Cache,  string)  (iiif image. Image,  e 
NewImageFromConf ig( *iiifconfig. Conf ig,  string)  (iiif image. Image,  error) 

> 

The  idea  here  is  that  the  bulk  of  the  go-iiif  code  isn't  aware  of  how  images  are 
being  processed,  or  who  is  processing  them,  only  that  it  can  reliably  pass  around 
things  that  implement  the  image .  Image  interface  (the  go-iiif  image  interface, 
not  the  Go  language  image  https://goiang.org/pkg/image/  interface). 


Drivers  are  expected  to  "register"  themselves  through  the 
driver .  RegisterDriver  method  at  runtime.  For  example: 


package  native 
import  ( 

iiif driver  "github.com/go-iiif/go-iiif/driver" 

) 

func  init( )  { 

dr,  _  :=  NewNativeDriver ( ) 

iiif driver . RegisterDriver ( " native ",  dr ) 

} 

And  then  in  your  code  you  might  do  something  like  this: 


import  ( 

"context " 

"github.com/aaronland/gocloud-blob-bucket" 

_  "github.com/ go-iiif /go-iiif /native" 

iiif conf ig  " github . com/ go-iiif /go-iiif /config" 

iiif driver  "github.com/go-iiif/go-iiif/driver" 

) 

ctx  :=  context .Background ( ) 

conf ig_bucket ,  _  :=  bucket .OpenBucket( ctx,  "file: ///etc/go-iiif " ) 
cfg,  _  :=  conf ig.NewConfigFromBucket (ctx,  conf ig_bucket ,  "conf ig. json" ) 
driver,  _  :=  iiif driver .NewDriverFromConf ig(cfg) 


That's  really  the  only  change  to  existing  code. 


Careful  readers  may  have  noticed  the  calls  to  bucket .  OpenBucket  and 
conf  ig  .NewConf  igFromBucket,  as  well  as  the  use  of  the  gocloud-blob- 
bucket  https : //github. com/ aaronland/ gocloud-blob-bucket  package,  to 
load  go-iiif  configuration  files.  All  of  these  things  are  discussed  below  but  in  the 
meantime  the  only  other  change  is  to  update  the  previously  default 
graphics  .  source  property  in  the  configuration  file  from  VIPS  (or  vips)  to 
native. 


For  example,  this: 


"graphics":  { 

"source":  {  "name":  "VIPS"  } 


} 


Becomes: 


"graphics":  { 


"source" : 


{  "name":  "native"  } 


} 

The  value  of  the  graphics  .  source  property  should  match  the  name  that  driver 
uses  to  register  itself  with  go-iiif . 


The  rest  of  the  code  in  go-iiif  has  been  updated  to  expect  a  driver .  Driver 
object  and  to  invoke  the  relevant  NewImageFrom.  .  .  methods  as  needed.  It  is 
assumed  that  the  driver  package  in  question  will  also  define  its  own  implementation 
of  the  go-iiif  image .  Image  interface.  For  concrete  examples  you  can  take  a 
look  at  the  following: 

•  https  ://gith  ub.com/ go-iiif 7, go- 
iiif/tree/master/native  https  :  //github .  com/go-iiif /go- 
iiif  /tree/master/native 

•  https://githllb.com/gO-iiif/gO-iiif-vipS  https  :  //github .  com/go- 
iiif/  go-iiif-vips 


Buckets 


negative:  San  Francisco  International  Airport  (SFO),  custodial  staff,  1968,  Collection  ofSFO  Museum,  20 11. 032. 1707 


Starting  with  version  2  the  go-iiif  package  uses  the  Go 

Cloud  https :  / / gocioud .  dev/  Bucket  and  Blob  interfaces  for  reading  and 
writing  all  files.  For  example,  instead  of  doing  this: 


cfg,  _  :=  config.NewConfigFromFile( " /etc/go-iiif /conf ig. json" ) 


You'd  do  this,  now: 


conf ig_bucket ,  _  :=  bucket .OpenBucket (ctx,  "file: ///etc/go-iiif " ) 
cfg,  _  :=  conf ig.NewConfigFromBucket (ctx,  conf ig_bucket ,  "conf ig. json" ) 


This  allows  for  configuration  files,  and  others,  to  be  stored  and  retrieved  from  any 
storage  source  (or  bucket)  that  is  supported  by  the  Go  Cloud 


package  https : //gocioud.dev/howto/biob/#services  ,  notably  remote 
storage  services  like  AWS  S3. 


The  source  and  caching  layers  have  also  been  updated  accordingly  but  support 
for  the  older  Disk,  S3  and  Memory  sources  has  been  updated  to  use  the  Go 
Cloud  packages  so  there  is  no  need  to  update  any  existing  go-iiif  configuration 
files.  For  example,  in  the  following  two  snippets  both  the  Disk  and  S3  sources  and 
their  corresponding  Blob  configurations  are  functionally  the  same. ..almost. 


These  two  source  definitions  are  functionally  the  same: 

"images":  { 

"source":  {  "name":  "Disk",  "path":  " /usr/local/go-iiif /docker/source"  }, 

"source":  {  "name":  "Blob",  "path":  "file: ///usr/local/go-iiif /docker/source"  }, 

}, 

These  two  cache  defintions  are  the  same  with  the  exception  of  the  acl= 
parameter,  described  below,  in  the  second  defintion: 

"derivatives":  { 

"cache":  {  "name":  "S3",  "path":  "sfomuseum-iiif " ,  "prefix":  "misc",  "region":  "us-east-1", 
"cache":  {  "name":  "Blob",  "path":  "s3 : ///sfomuseum-iiif ?region=us-east-l&credentials=sessio 

} 

As  mentioned  above  we  are  using  the  gocloud-blob- 

bucket  https://github.com/aaronland/gocloud-blob-bucket  to  open 
"buckets" .  This  is  a  thin  wrapper  around  the  core  Go  Cloud  packages  that  that 
allows  us  to  define  credentials  as  named  parameters  in  URI  strings. 


Under  the  hood  the  Blob  cache  supports  an  optional  acl={ACL}  query  parameter 
in  the  path  property  (which  is  equivalent  to  a  Go  Cloud  URI  definition).  This  is  to 
account  for  the  inability  to  assign 

permissions  https://github.com/google/go-cloud/issues/1108  when 
writing  Go  Cloud  blob  objects.  Currently  the  acl=ACL  parameter  is  only  honoured 
for  s3:/  /  URIs  but  patches  for  other  sources  https://github.com/go- 
iiif  /  go-iiif /blob/master/cache/blob,  go  would  be  welcome. 


URIs 


booklet:  Air  Traffic  Control,  1974,  Collection  ofSFO  Museum,  2002.134.238 


As  of  go- ii if  version  2  image  URIs  no  longer  use  simple  strings  for  paths  and 
filenames  but  a  string-based  syntax  that  encodes  instructions  for  how  a  path  should 
be  interpreted  and  manipulated. 


go-iiif-uri  URI  strings  https :  //github.com/go-iiif/go-iiif-uri  are  defined 
by  a  named  scheme  which  indicates  how  a  URI  should  be  processed,  a  path  which  is 
a  reference  to  an  image  and  zero  or  more  query  parameters  which  are  the  specific 
instructions  for  processing  the  URI. 


Like  image  processing  go-iiif-uri  URI  processing  is  handled  by  various 
"drivers"  that  conform  to  a  URI  interface: 


type  URI  interface  { 

Driver()  string 
String()  string 
Origin()  string 

Target ( *url .Values )  (string,  error) 

> 

This  allows  developers  to  define  their  own  URI  processing  instructions  outside  the 
default  schemes  which  are  part  of  the  go-iiif-uri  https :  //github .  com/go- 
iiif /go-iiif-uri  package.  Default  URI  schemes  are: 


file:// 

The  file :  /  /  URI  scheme  is  basically  just  a  path  or  filename.  It  has  an  optional 
target  property  which  allows  the  name  of  the  source  image  to  be  changed.  These 
filenames  are  not  the  final  name  of  the  image  as  processed  by  go-iiif  but  the 
name  of  the  directory  structure  that  files  will  be  written  to,  using  the  IIIF 
instructions-based  syntax  https  :  //iiif  .  io/api/image/2  .  l/#uri- syntax  for 
URIs. 


For  example: 


file: ///path/to/source/image. jpg 

file: ///path/ to/ source/ image . j pg? tar get=/path/to/ target/ image . jpg 


idsecret:// 


The  idsecret :  /  /  URI  scheme  is  designed  to  rewrite  a  source  image  URI  to 
{UNIQUE_ID}  +  {SECRET}  +  {LABEL}  style  filenames.  For  example  cat .  jpg 
becomes  1234_s33kret_b.  jpg  and  specifically 

123/4/  1234_s33kret_b.  jpg  where  the  unique  ID  is  used  to  generate  a 
nested  directory  tree  in  which  the  final  image  lives. 


For  example: 


idsecret: ///path/to/source/image . jpg?id=1234&secret=s33kret&secret_o=seekr3t&label=b 

The  idsecret :  /  /  URI  scheme  was  developed  for  use  with  go-iiif 
"instructions"  files  https : //github . com/ go-iiif/ go-iiif#instructions- 
fiies  where  a  single  image  produced  multiple  derivatives  that  need  to  share 
commonalities  in  their  final  URIs. 

rewrite:// 

The  rewrite :  /  /  URI  scheme  is  a  variant  of  the  file :  /  /  URI  scheme  except 
that  the  target  query  parameter  is  required  and  it  will  be  used  to  redefine  the  final 
URI,  rather  than  just  its  directory  tree,  of  the  processed  image. 


For  example: 


rewrite: / //path/to/source/image. jpg?target=/path/to/target/picture . jpg 


I  Brooklyn  Integers  I  Artisanal  hand-  X 
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@brookIyninteger  I  established  2012 1  what  is  this  I  create  I  api 
visit  our  San  Francisco  branch ,  Mission  Integers  and  our  friends  in  Londo. 
London  Inlevers. 


Here's  an  abbreviated  example  taken  from  the  process/ parallel  .go  code  that 
processes  a  single  source  image,  defined  as  an  idsecret :  /  /  URI,  in  to  multiple 
derivatives  defined  in  an  "instructions"  file. 


The  idsecret :  /  /  URI  is  output  as  a  string  using  the  instructions  file  to  define 
the  label  and  other  query  parameters.  That  string  is  then  used  to  create  a  new 
rewrite :  / /  URI  where  source  is  derived  from  the  original  idsecret :  / /  URI 
and  the  target  is  a  newly  generated  URI  string. 


go  func(u  iiifuri.URI,  label  Label,  i  IIIFInstructions )  { 

//in  this  example  we  assume  that  u. String ()  is: 

/ /  idsecret: ///path/to/source/image. jpg?id=1511015579 

var  process_uri  iiifuri.URI 

switch  u. Driver ()  { 
case  "idsecret": 

//  here  we  are  defining  specific  parameters  derived  from 
//  the  instructions  file  to  be  used  when  calling  u.Target() 

str_label  :=  fmt . Sprintf ( "%s" ,  label) 


opts  :=  &url .Values{ } 


opts . Set (" label" ,  str_label) 
opts. Set ( "format" ,  i. Format) 

if  str_label  ==  "o"  { 

opt s. Set ( "original" ,  "1") 

} 

target_str,  _  :=  u. Target (opts ) 

//  u.Origin()  is  /path/to/source/image . jpg 
origin  :=  u.Origin() 

//  now  we  create  a  new  "rewrite:///"  URI  with  the  original 
//  source  image  and  the  newly  created  "target"  URI  and  use 
//  that  for  processing  the  image  in  question 

rw_str  :=  fmt . Sprintf ( "%s?target=%s" ,  origin,  target_str) 
rw_str  =  iiifuri.NewRewriteURIString(rw_str) 

rw_uri,  _  :=  iiifuri .NewURI (rw_str) 

process_uri  =  rw_uri 


default: 

process_uri  =  u 

} 

pr .ProcessURIWithlnstructions (process_uri,  label,  i) 
}(u,  label,  i) 


Resulting  in  the  following  images,  and  directory  structure,  being  produced: 
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go-iiif-uri  URI  strings  are  still  a  work  in  progress.  They  may  still  change  a  bit 
around  the  edges  but  efforts  will  be  made  to  ensure  backwards  compatibility  going 
forward. 


Tools 


lighter:  Lockheed  Constellation  with  route  map,  c.  1950s,  Collection  of  SFO  Museum,  2003 .065 .109 


Everything  is  the  same  with  all  the  command  line 

tools  https://github.eom/go-iiif/go-iiif#toois  that  are  bundled  with  go- 
iiif ...  almost. 

The  -conf  ig  flag  has  been  deprecated  in  favour  of  the  -conf  ig-source  and  - 
conf  ig-name  flags  but  will  still  be  honoured  and  used  to  automatically  populate 
the  newer  flags. 

The  bulk  of  the  logic  behind  each  tool,  including  parsing  command  line  arguments 
has  been  moved  in  to  the  go-iiif  tools  namespace  https :  //github.com/go- 
iiif  / go-iiif /tree/master/ tools  which  allows  different  go-iiif  image 


processing  packages  to  share  functionality  while  taking  care  to  load  their  relevant 
drivers. 


For  example,  this  is  what  the  go-iiif- vips/cmd/iiif- 

proceSS  https : // github.com/ go-iiif / go-iiif-vips /blob/master/ cmd/ iiif- 
process/main . go  tool  looks  like: 


package  main 
import  ( 

"context " 

_  "github . com/ go-iiif/ go-iiif-vips " 

"github.com/go-iiif/go-iiif/tools" 

) 

func  main( )  { 

tool,  _  :=  tools .NewProcessTool ( ) 
tool . Run ( context . Background ( ) ) 

> 

Here's  an  example  using  the  same  iiif  -process  tool  from  both  the  go-iiif  # 
and  go-iiif-vips  #  packages,  the  latter  via  a  Docker 
Container  https : //github . com/ go-iiif/ go-iiif- 
vips  /blob  /master  /Docker  file  .  process  : 


$>  go  run  -mod  vendor  cmd/iiif-process/main.go  \ 

-instructions-source  f ile: ///usr/local/go-iiif /docker/config  \ 

-conf ig-source  file: ///usr/local/go-iiif /docker/config  \ 

' idsecret : ///spanking. jpg?id=15110 15579 1 

{ " /spanking. jpg" : { "dimensions" : { "b" : [ 1461 , 1536 ] , "d" : [ 3507 , 3508 ] , "o" : [ 3897 , 4096 ] } , "palette" : [ { "name" : 

$>  Is  -a  docker /cache/ 151/101/557/9/1511015579/ 

1511015579_8Un90mD46ZYXzatvTOrqX0NKzMyIlFuh_o.jpg 
1511015579_mLB9f j6X jNtolHgDsl4fKj8vOg6wOvm3_b.png 
1511 0 15579_mLB9f  j  6X jNtolHgDsl4  f K j  8vOg6wOvm3_d . jpg 

$>  docker  run  -v  /usr/local/go-iiif-vips/docker: /usr/local/go-iiif  \ 
go-iiif-vips-process  /bin/iiif-process  \ 

-conf ig-source  file: ///usr/local/go-iiif /conf ig  \ 

-instructions-source  file: ///usr/local/go-iiif /config  \ 

' idsecret : / //freedom. jpg?id=15 110 15579 ' 

{ " /freedom. jpg" : { "dimensions" : {"b" : [ 1216, 1536] , "d" : [320,320] , "o" : [2852,3600]}, "palette" : [ { "name" : "#a 

$>  docker  run  -v  /usr/local/go-iiif-vips/docker : /usr/local/go-iiif  \ 
go-iiif-vips-process  \ 

Is  -a  /usr/local/go-iiif /cache/151/ 10 1/557/9/15 110 15579/ 

1511 0 15579_hYWEkOK2Ui4eKzheg JFt7bpz JUYlgX0t_b . png 
1511015579_hYWEkOK2Ui4eKzhegJFt7bpzJUYlgXOt_d.jpg 
1511015579_uB9fbr7X9yelGmVnawqxar8PwqS9s JvK_o. jpg 


So,  that's  version  2  of  go-iiif .  There's  not  a  lot  of  new  functionality  (unless  you 
count  increased  portability)  but  these  are  important  changes  that  will  hopefully 
make  using  the  code  a  little  easier  and  a  lot  more  flexible. 

In  closing,  here  are  some  screenshots  that  were  captured  while  tile-seeding  for 
zoomable  images,  in  version  2,  was  being  developed  and 

tested  https://github.com/go-iiif/go-iiif-www  .  In  these  images  you  can 
see  some  of  the  mistakes  we  made  along  the  way  as  well  as  where  we're  going  next! 


Note:  The  image,  above,  of  the  so-called  "Spanking  Cat"  is  not  part  of  SFO 
Museum's 

collection  https  :  /  /collection .  cooperhewitt .  org/ob  jects/18382  391/  but  it 
has  become  the  default  reference  image  for  the  go-iiif  project  which  is  why  we 
were  using  it  for  testing. 


Links 


•  https://github.com/gO-iiif/gO-iiif  https  :  //github .  com/go-iiif  /go- 
iiif 


•  https://github.com/gO-iiif/gO-iiif-vips  https  :  //github .  com/go- 
iiif/  go-iiif-vips 


https://github.com/go-iiif/go-iiif-uri  https :  /  /  github .  com/ go- 
iiif/go-iiif-uri 


2019-11-13 


it's  like  trying  to  make  a 
grilled  cheese  sandwich  in  a 

toaster 

The  logical  conclusion  of  the  services  economy... 


The  logical  conclusion  of  the 
services  economy  is  a 
museum 


Zadie  Smith 


Recently,  Micah  Walter  wrote  on 

Twitter  https  :  /  /twitter . com/micahwalter/ status  / 1 19535  0584 


611811329 


Thinking  about  a  typical  “tech  stack”  for  a  small  to 
mid-size  museum  or  similar  cultural  org.  What’s  the 
minimum  off  the  shelf/cloud  based  infrastructure  to 
run  an  org?  (thread) 


To  which  I 

replied  https : / / twitter . com/ thisisaaronland/ status/119536 
5426894557185  : 


@davidnunez  @micahwalter  @morphogencc  the 
“minimum  stack”  is  staff  but  no  one  wants  to  believe 
that  so  the  sector  continues  to  chase  ponies 


A  short  back  and  forth  followed,  involving  a  handful  of  people,  until 

David  Nunez 

Said  https : / / twitter . com/ davidnunez/status/119536898460 


8030720 


@morphogencc  @thisisaaronland  @micahwalter  I'll 
just  say  it.  I'd  rather  a  museum  double  the  income  of 
all  the  front  of  house  teammates  vs.  hire  an 
expensive  in-house  digital  team.  Go  spend  some 
time  looking  at  museum  digital  team  org  charts  and 
the  stuff  that  would  be  better  served  by  outside 
providers  is  quite  obvious. 


And  I 

replied  https : / / twitter . com/ thisisaaronland/ status/119537 
5024108007425  : 


@davidnunez  @morphogencc  @micahwalter  this  is 
a  good  example  of  how  and  why  twitter  is  an  awful 
medium  for  discussing  complex  issues  so  I  will  write 
about  these  things  elsewhere  / 1  will  only  say  that  the 
sector  is  culturally  indisposed  to  changes  that  might 
offset  its  financial  challenges  - 

https://www.aaronland.info/weblog/20 1 3/05/05/design- 
thanking/#face 


Like  a  lot  of  people  in  2019, 1  continue  to  question  whether  or  not  to 
participate  with  Twitter  anymore.  I  still  post  things  here  and  there  but 


I  have  stopped  trying  to  use  it  for  the  purpose  of  "conversation" 
despite  the  company's  best  efforts  to  market  itself  as  a  platform  for 
that  sort  of  thing. 

The  demands  of  squeezing  meaning  in  to  140,  or  even  280, 
characters  typically  require  the  use  of  short-hand,  figures  of  speech 
and  tricks  of  the  eye  (so  to  speak).  At  their  very  best  these  linguistic 
gymnastics  can  be  akin  to  poetry.  At  their  worst  they  serve  as 
unintended  landmines  of  allusion,  sheering  comments  of  their 
nuance  and  transforming  genuine  misunderstanding  and  honest 
negligence  in  to  hostility  and  malice.  We  have  a  hard  enough  time 
creating  understanding  with  the  benefit  of  whole  paragraphs  and 
essays,  and  books  even,  so  it  should  come  as  no  surprise  that 
complex  arguments  reduced  to  elevator 

pitches  https:  /  /  g  n  •  w  ikipGdici  •  oircj/  wiki  /El  gv  citoir  pitch  ^See 

what  I  did  there?)  become  the  cause  of  unwanted  conflict. 


Yiyun  Li 


Take  for  example  my  claim  that  "...the  (museum)  sector  continues  to 
chase  ponies"  or  the  title  of  this  blog  post.  Both  are  hyperbole  and 
the  latter  is  factually 

untrue  https : / /WWW. aaronland. inf o/weblog/2019/ 04/ 08 /post/ 
#mw- 2019-003  .  The  title  of  this  blog  post  is  taken  from  a  talk  I've 
been  threatening  to  do  for  years  now  and  is  a  deliberate  provocation. 
It  is  meant  to  draw  attention  to  a  problem  that  while  not  as  dire  as  the 
title  suggests  is  still  real  and  should  be  of  concern  to  the  cultural 
heritage  sector.  The  thrust  of  the  argument  is  that  the  trend  in 
museums  has  been  to  do  less  and  less  in-house  save  writing  the 


contracts  we  use  to  hire  and  manage  the  third  parties  that  do  the 
actual  work  necessary  for  a  museum  to  operate. 


Which  brings  me  back  to  David's  tweet.  He  makes  two  points: 

1.  I'd  rather  a  museum  double  the  income  of  all  the  front 
of  house  teammates  vs.  hire  an  expensive  in-house 
digital  team. 

2.  Go  spend  some  time  looking  at  museum  digital  team  org 
charts  and  the  stuff  that  would  be  better  served  by 
outside  providers  is  quite  obvious. 

I'd  like  to  address  them  in  reverse  order.  First,  are  museums  better 
served  by  outside  providers  than  in-house  digital  teams?  There  are  a 
few  different  ways  to  look  at  this  question. 

Have  teams  dedicated  to  technology  and  "the  digital"  inside  of 
museums,  having  been  given  a  wide  berth  and  substantial  budgets 
over  the  last  decade,  lived  up  to  their  promise?  I  think  it's  pretty  clear 
that  when  you  average  out  all  the  efforts  of  the  last  ten  years, 
including  the  successes,  the  answer  is:  No.  That's  not  something 
anyone  wants  to  hear  but  it's  important  to  be  clear-eyed  and  honest 
when  we  reflect  on  past  work  in  order  to  see  where  all  the  good 
intentions  failed  in  the  face  of  operational  realities. 


The  cultural  heritage  sector  raised  and  spent  a  lot  of  money  for 
digital  intiatives  and  there  isn't  much  left  to  show  for  it.  Few  projects 
are  still  standing  and  if  they  are  survive  mostly  on  life- support  or 
benign  neglect.  The  number  of  people  who  have  outright  left  the 
cultural  heritage  sector  as  a  result  of  their  experiences  working  on 
those  projects  is  discouraging.  I  don't  however  think  that  it  is 
necessarily  an  indictment  of  in-house  digital  teams,  per  se. 


For  starters,  most  teams  could  barely  be  considered  large  enough  to 
form  a  quorum.  Of  all  the  teams  that  were  started  only  a  handful  had 
enough  people  to  work  effectively  and,  put  bluntly,  they  should  have 
built  proverbial  rocket-ships  given  all  the  resources  and  freedom 
they  were  given.  They  did  not. 


Worse,  many  let  all  the  good  will  they  were  afforded  slip  away 
through  their  actions,  or  inaction  because  of  overpromising  and 
underdelivering,  and  everyone  else  has  suffered  the  consequences  of 
their  failures.  I  have  my  own  personal  list  of  suspects  in  this  regard 
but  I  think  it's  important  to  understand  that  when  I  say  "they"  I  am 
speaking  collectively  of  anyone  who  has  said  the  words  "digital"  and 
"museum"  together  in  a  sentence  anytime  in  the  last  ten  years.  I 
count  myself  among  those  who  did.  We  all  did  this,  together. 


The  reason  the  failures  of  those  few  teams  with  sufficient,  or  even 
just  adequate,  resources  is  important  is  that  it's  not  as  though  the 
organizational  dynamics  and  challenges  of  cultural  heritage 
institutions  have  changed  much  in  the  interim.  Getting  anything  done 
in  a  museum  is  hard  enough  as  it  is  so  imagine  trying  to  navigate 
those  realities  and  do  "the  digital"  with  insufficient  resources  and 
skeleton  crews  while  those  with  the  means  to  be  doing  better...  didn't. 


I  choose  to  believe  that  the  mistakes  made  were  genuine.  I  choose  to 
believe  that  everyone  was  trying  their  best,  with  good  intentions  and 
honest  motive.  I  don't  think  that  should  shield  us  from  what  is 
ultimately  a  pretty  damning  retrospective  of  our  efforts.  We  can  and 
should  do  better  but  let's  acknowledge  that  this  work  has  been  made 
harder  by  our  failures. 

In  my  reply  to  David  I  pointed  to  a  talk  I  did  at  Museums  and  the 
Web  in 

2013  http  s : / /www. aaronland . info/weblog/2013/ 05/ 05 /design 
-thanking/#f  ace  about  institutional  voice.  During  that  talk  I  said: 


It's  an  interaction  model  that  tries  to  account  for  the 
shift  from  the  exhibition  being  the  principle  the  unit 
of  currency  for  an  institution  to  the  entire  collection 
being  that  measure.  That's  not  a  shift  that  I  think 
everyone  has  acknowledged  or  is  necessarily  happy 
about  but  it's  hard  to  deny  that  it's  happening. 


I  mention  it  because  this  is  still  a  transition  we  are  living  through.  An 
always-on  and  connected  network  means  that  an  institution  is  no 
longer  quantified  by  the  atomic  isolation  of  the  exhibition  and  the 
exhibition  catalog  but  rather  its  ambient  presence  and  the  ease  with 
which  its  present  can  be  connected  to  its  past,  not  to  mention 
everything  else. 


In  other  words:  Everything  a  museum  does  is  connected  to 
everything  a  museum  has  done  not  just  for  those  with  institutional 
knowledge  but  for  those  that  an  institution  exists  to  serve,  namely 
everyone  else.  In  other  words:  The  old  model  of  working  which  can 
be  described  as  "fire  and  forget"  is  one  that  no  longer  matches 
people's 

expectations  https : / /www.aaronland. info/weblog/2017/ 02/20/ 
mostly/#museumnext 


Cultural  heritage  institutions  are  not  used  to  doing  "version  two"  of  a 
project  but  the  ability  to  do  so  is  precisely  what  the  internet  and 
digital  technology  affords.  It  shouldn't  really  come  as  a  surprise  that 
organizations  have  approached  digital  initiatives  with  the  same 
mindset  that  they've  brought  to  bear  on  everything  else.  It  does, 
however,  account  for  many  of  the  challenges  those  digital  projects 
have  to  overcome. 


Most  organizations  are  still  culturally  hard-wired  for  high-stakes 
projects  that  culminate  in  a  big  splashy  "reveal"  which  buoys  an 
institution  for  the  time  it  takes  to  complete  the  next  project.  In  this 
model  the  skills  and  efforts  of  third-party  agencies  to  produce  a 
complimentary  digital  product  are  a  good  fit.  Those  agencies  charge 
a  premium  for  their  work  but  out  of  business  necessity  that  work  is 
predetermined  and  cast  in  stone,  save  for  a  support  contract  to 
account  for  minor  changes  or  fixes.  That  work  is  rarely  if  ever 
revisited  and,  again  out  of  operational  necessity,  not  designed  to  be 
reconsidered  once  delivered. 


Historically,  institutions  have  been  left  with  a  digital  infrastructure 
consisting  of  expensive  one-offs  that  do  not  age  well,  almost  never 
interoperate  with  one  another  and  are  ill-suited  to  adaptation.  If  you 
believe  that  the  promise  of  these  technologies  is  only  to  compliment 
an  exhibition  in  the  moment  then  it's  an  entirely  legitimate  way  to 
operate. 


Aanchal  Malhotra 


I  think  the  promise  of  digital  technologies,  and  the  internet,  is 
something  very  different.  I  think  what  these  technologies  allow  us  is 
the  freedom,  both  intellectually  and  importantly  financially,  to 
dampen  the  high- stakes  nature  of  what  a  cultural  heritage  institution 
does.  I  think  it  allows  the  tangible  ability  to  produce  more  facets  and 
more  avenues  by  which  an  institution  and  the  public  at  largely  might 
consider  a  topic. 

The  present  offers  us  the  ability  to  harness  the  databases,  the 
publishing  tools,  the  programming  languages  and  networks  of 
communities  and  broadcast  channels  that  have  been  created,  in  many 


instances  for  entirely  other  purposes,  in  the  service  of  our  collections 
and  the  mandates  that  our  institutions  claim.  The  goals  aren't  new  but 
what  is  new  is  that  many  of  those  goals  are  actually  within  reach 
now.  That  these  goals  are  within  reach  does  not,  however,  mean  they 
are  self-realizing. 


The  whole  point  of  a  digital  team  inside  an  institution  is  to  do  those 
things.  Not  only  the  big  reveal  but  "version  two"  and  then  "version 
three"  and  so  on.  The  purpose  of  a  digital  team  inside  an  institution 
is  to  build  and  nurture  the  infrastructure  so  that  each  subsequent 
project  is  easier  than  the  last  or  at  the  very  least  creates  new 
challenges  rather  than  retreading  the  same  ground  over  and  over 
again.  These  are  precisely  the  sorts  of  things  that  outside  agencies 
are  not  set  up  to  do.  It's  not  their  business  and  no  amount  of  wishful, 
or  magical,  thinking  on  the  part  of  their  clients  (the  cultural  heritage 
sector)  will  make  it  so. 


"Infrastructure"  here  should  be  understood  to  mean  both  the 
technological  and  cultural  scaffolding  that  supports  an  institution. 
Another  crucially  important  function  of  an  in-house  team  is  to  be 
able  to  respond  and  adapt  to  mistaken  assumptions  along  the  way.  To 
reduce  "the  cost  of  failure",  real  or  imagined,  from  being  seen  as 
catastrophic  to  being  understood  as  addressable. 


To  make  these  ideas  concrete  consider  the  following: 


Making  ‘Dive  into 

Color’  https : / /labs . cooper hewitt . org/2  0 18/maki 
ng-dive-into-color/  ,  Oliva  Vane  (2018) 

Process  Lab:  Citizen  Designer  Digital  Interactive, 
Design  Case 

Study  https : / / labs . cooperhewitt . org/ 2016/ proce 
ss -lab-citizen-designer-digital -inter active- 
design-case-study/  ,  Lisa  Adang  and  Rachel 
Nachman  (2016) 

Traveling  our  technology  to  the 

U.K.  https : //labs . cooperhewitt . org/2  0 16 /travel 
ing-our-technology-to-the-u-k/  ,  Micah  Walter 
(2016) 

Museums  and  the  Web  Conference  Recap: 
Administrative  Tools  at  Cooper 

Hewitt  https  :  / /labs  .  cooperhewitt .  org/2  016 /muse 
urns -and- the-web-conference-recap- 
administ rat ive- tools -at-cooper-hewitt/  and 
Winning  (and  losing)  hearts  and  minds  of  museum 
staff:  Administrative  interfaces  at  Cooper 
Hewitt  http:  / /mw2  016  .museumsandtheweb.com/pape 
r /winning- and- losing- heart s-and-minds -of - 
museum-staf f-administ rat ive-inter faces -at- 


cooper-hewitt/  ,  Lisa  Adang  and  Sam  Brenner 
(2016) 


On  Exhibitions  and 

Iterations  https :  / /labs  .cooperhewitt.org/20i6/on 
-exhibitions-and-iterations/  ,  Sam  Brenner 
(2016) 

Iterating  the  “Post-Visit 

Experience”  https: / /labs .cooperhewitt.org/2 015 
/iterating-the-post-visit-experience/  ,  Sam 

Brenner  (2015) 

“ Visual  Consistency”  -  tweaking  the  online 
Collection  https  :  / /labs  .cooperhewitt.org/2  015/vi 
sual -cons is tency- tweaking- the-online- 
coiiection/  ,  Sam  Brenner  and  Ayham  Ghraowi 
(2015) 

Happy  Staff  =  Happy  Visitors:  Improving  Back-of- 
House 

Interfaces  https : //labs .cooperhewitt.org/2015/h 
appy-staf f -happy- visitor s- improving- the- 
interfaces-of-back-of-house-pen-ticketing- 

tooi s  /  ,  Katie  Shelley  (2015) 


•  Redesigning  Post-Purchase 

TouchpointS  https  :  / / labs  .  cooperhewitt .  org/ 2  015 
/redesigning-post-purchase-touchpoints/  ,  Katie 

Shelley  (2015) 

These  are  all  blog  posts  from  the  Cooper  Hewitt 

Labs  https://iabs.cooperhewitt.org  website.  There  are  three 

really  important  things  to  note  about  this  list: 

1.  None  of  this  work  was  done  by  me  or  Seb 

Chan  https://www.freshandnew.org/  even  though 
we  are  the  two  names  most  often  associated  with 
Cooper  Hewitt's  digital  efforts  as  part  of  the  museum's 
re-opening  in  2014.  In  fact,  save  for  the  last  two  posts  in 
the  list,  neither  of  us  worked  at  the  museum  when  this 
work  happened. 

2.  This  work  was  done  in-house  and  on  staff-time,  all 
while  maintaining  museum  operations  including  all  the 
work  we'd  done  for  the  re-opening.  Spend  some  time 
reading  what  the  team  did  and  then  try  to  imagine  how 
much  money  outside  firms  would  charge  for  the  same 
effort. 

3.  The  "digital"  team  at  Cooper  Hewitt  was  never  more 
than  five  people  at  any  given  point  in  time.  Five  people 


is  neither  small  nor  big  in  a  museum  context  but  it 
should  give  you  an  idea  of  what  today's  technology 
enables  you  to  do. 


Let  me  be  crystal  clear  about  something:  This  is  how  it  should  be. 
This  is  why  you  build  and  nurture  and  sustain  core  capacity  in- 
house.  You  do  it  because  it  makes  possible  what  was  impossible,  or 
so  impractical  as  to  seem  impossible,  before. 


It  doesn't  necessarily  make  it  easy  but  it  does  make  it  possible.  The 
cultural  heritage  sector  has  an  unfortunate  habit  of  confusing  "easy" 
and  "possible"  and  the  sooner  we  stop  equating  the  two  the  sooner 
we'll  all  start  doing  better  work. 

Even  though  Seb  and  I  were  the  public  face  of  the  museum's  digital 

efforts  it  was  never  just  the  two  of  us.  Micah 

Walter  https :  / / micahwaiter .  com/  and  Katie 

Shelley  https://katieshelly.art/  and  Sam 

Brenner  https://samjbrenner.com/  (and  Pam 

Horn  https :  / / twitter .  com/ pameiahorn  )  were  there  through  it 

all.  They  deserve  more  recognition  for  the  work  they  did.  They 

deserve  more  recognition  because  they,  and  Lisa 

Adang  http://iisaadang.com/  and  Rachel 

Nackman  https :  / / racheinackman .  com/  ,  picked  up  from  Seb 

and  me  when  we  left  the  museum  and  kept  on  running. 


It  bears  repeating:  This  is  how  it  should  be.  This  is  why  you  build 
and  nurture  and  sustain  core  capacity  in-house.  You  do  it  because  it 
makes  possible  what  was  impossible  before. 


I  am  proud  of  the  work  that  I  did,  personally,  at  Cooper  Hewitt. 
Much  has  been  said  and  written  about 

it  https://aaronland.info/cooperhewitt/  but  one  of  the 
aspects  of  that  work  which  hasn't  been  addressed  as  much  was  the 
awareness  and  understanding  that  in  order  for  that  work  to  be 
considered  a  "success"  it  had  survive  my  (and  Seb's)  departure.  In 
that  way  I  am  equally  proud  of  the  work  we  did.  That  is  why  you 
build  and  nurture  and  sustain  core  capacity  in-house. 

At  the  end  of  our  tenure  Seb  and  I  wrote  a  13, 000  word 

paper  https : //mw2015 .museumsandtheweb.com/paper/ strategi 
es-against-architecture-interactive-media-and- 
transf ormative-technology-at-cooper-hewitt/  about  our 
efforts  at  the  Cooper  Hewitt.  In  the  closing  remarks  we  said: 


As  a  sector  we  have  spent  a  couple  of  decades 
making  excuses  for  why  “digital”  can’t  be  made  core 
to  staffing  requirements  and  the  results  have  ranged 
from  unsatisfying  to  dismal. 


The  shift  to  a  ‘post-digital’  museum  where  “digital 
[is]  being  naturalized  within  museums’  visions  and 
articulations  of  themselves”  (Parry,  2013)  will 
require  a  significant  realignment  of  priorities  and  an 
investment  in  people.  The  museum  sector  is  not 
alone  in  this  -  private  media  organisations  and  tech 
companies  face  exactly  the  same  challenge.  Despite 
‘digital  people’  and  ‘engineers’  being  in  high 
demand,  they  should  not  be  considered  an 
‘overpriced  indulgence’  but  rather  than  as  an  integral 
part  of  the  already  multidisciplinary  teams  required 
to  run  a  museum,  or  any  other  cultural  institution. 


The  flow  of  digital  talent  from  private  companies  to 
new  types  of  public  service  organizations  such  as  the 
Government  Digital  Service  (UK),  18F  (inside  GSA) 
and  US  Digital  Service,  proves  that  there  are  ways, 
beyond  salaries,  to  attract  and  retain  the  specialist 
staff  required  to  build  the  types  of  products  and 
services  required  to  transform  museums.  In  fact,  we 
argue  that  museums  (and  other  cultural  institutions) 
offer  significant  intrinsic  benefits  and  social  capital 
that  are  natural  talent  attractors  that  other  types  of 
non-profits  and  public  sector  agencies  lack.  The 
barriers  to  changing  the  museum  workforce  in  this 


way  are  not  primarily  financial  but  internal, 
structural  and  kept  in  place  by  a  strong  institutional 
inertia. 


Which  brings  me  back  to  David's  first  point  that  he  would  "rather  a 
museum  double  the  income  of  all  the  front  of  house  teammates  vs. 
hire  an  expensive  in-house  digital  team". 


First,  I  wholeheartedly  agree  that  we  should  double  the  income  of 
front  of  house  staff  in  museums. 


Second,  I  think  pitting  one  group  of  museum  staff  against  another 
this  way  is  unhelpful  and  points  to  larger  structural  problems  about 
how  museums  are  funded  and  how  that  funding  gets  allocated.  I 
think  it  also  betrays  a  helplessness  (some  might  say  "realism")  in  the 
face  of  those  challenges.  The  landscape  of  these  challenges  is 
uneven.  It  is  especially  acute  in  North  America  where  the  lack  of 
public  funding  combined  with  the  roles,  functions  and  motives  of 
private  donors  and  boards  often  causes  the  whole  purpose  of  cultural 
heritage  institutions  to  be  called  in  to  question.  Overall,  though,  the 
sector  as  a  whole  is  long  overdue  for  a  critical  accounting  of  how  it 
spends  its  money.  My  own  feeling  is  that  we  might  do  well  to  stop 
flushing  it  away  on  unnecessary  and  over-priced 
buildings  https : / /WWW. aaronland. inf o/weblog/2 015/ 11/09 /ke 
inhoiz/#mcn  but  that  is  just  one  of  many  ways  we  could  do  better. 


In  2019,  digital  staff  is  only  expensive  relative  to  other  functions  at  a 
museum.  When  you  look  at  the  kinds  of  salaries  the  private  sector 
will  bear  for  that  same  digital  staff  it  only  serves  to  highlight  the 
unfair  salaries  the  cultural  heritage  sector  promotes  in  the  first  place. 
These  salaries  help  fuel  the  on-going  problem  of  retention  in  the 
sector  which  makes  building  and  sustaining  long-term  team-based 
efforts,  digital  or  otherwise,  even  harder  than  they  are  to  begin  with. 


When  you  consider  the  sum  totals  of  money  that  are  spent  on  outside 
contractors  and  especially  outside  technology  contractors  in  the 
cultural  heritage  sector  it  remains  something  of  a  mystery  how  it  is 
that  we  can't  both  raise  salaries  across  the  board  and  sustain  in-house 
digital  teams.  If  we  are  going  to  have  awkward  and  difficult 
conversations  about  how  and  where  resources  are  allocated  this  is 
where  I  would  start. 


Fabien  Marsaud 


Finally,  for  all  that  my  claims  about  the  problem  of  museum 
outsourcing  may  be  overstated  I  learned  recently,  during  a  hallway 
conversation  at 

MCN  https  : / /www. aaronland . inf o/weblog/2 019/1 1/09/mement 
o/#mcn  ,  that  a  growing  number  of  museums  have  considered 
terminating  their  permanent  curatorial  staffs  and  replacing  them  with 
contract  curators  hired  on  a  per-exhibition  basis.  This  is  not  an 
entirely  new  phenomenon  and  it  tracks  with  a  broader  trend  in 


academic  and  cultural  institutions  to  stop  supporting  tenured 
positions  that  allow  staff  to  pursue  research  for  its  own  sake. 


I  think  the  question  of  whether  or  not  to  outsource  curatorial  practice 
is  a  good  opening  to  discuss  the  broader  practice  of  outsourcing  in 
general  in  the  cultural  heritage  sector.  It  certainly  easier  for  more 
people  to  relate  to  than  the  question  of  whether  or  not  we  should 
outsource  digital  and  technology  roles.  This  is  a  larger  debate  that 
we,  as  a  community  of  practice,  should  have  because  I  think  that  one 
risk  of  relentless  outsourcing  is  that  museums  (and  friends)  will 
become  nothing  more  than  centers  of  production  rather  than 
scholarship. 

If  we  say  that  our  only  purpose  is  to  facilitate  the  assembly  of 
"content'1  in  the  service  of  "culture"  then  it’s  no  longer  clear  to  me 
what  distinguishes  the  cultural  heritage  sector  from  any  other  for- 
profit  entertainment  company.  If  we  are  unable  to  articulate,  even  to 
ourselves,  what  distinguishes  our  work  from  that  produced  by  the 
private  sector  then  maybe  it  really  is  time  to  admit  there's  nothing 
special  about  what  we  do.  And  importantly  there  are  other  people 
who  do  it  —  where  "it"  is  pure  and  selfish 

entertainment  https  :  / /WWW.  aaronland.  info/weblog/2  018/ 09/1 
2/distractions/#diorama  —  better  than  we  do. 


2019-11-25 


work  in  progress 


At  the  intersection  of  cartography  and  reality,... 


At  the  intersection  of 
cartography  and  reality,  take 
two 


The  first  "At  the  intersection  of  cartography  and  reality"  drawing  was 
done  in  the  back  seat  of  a  car  in 

Portugal  https : / /www. aaronland. inf o/weblog/2019/ll/ll/tar 
dio#postcards  and  mailed  to  a  friend  shortly  afterwards.  At  the 
time  I  was  asked  to  make  another  one.  This  is  that  drawing, 
including  at  various  stages  along  the  way. 


2019-12-02 


artificial  iconography 


Fact  Associations:  Fantastic  Futures  2019 


Fact  Associations:  Fantastic 
Futures  2019 


I  attended  the  plenary  sessions  of  the  second  Fantastic 
Futures  https : //library . Stanford . edu/ projects/fantastic- 
futures  conference  about  artificial  intelligence  in  libraries, 
archives  and  museums  yesterday.  I  took  notes  throughout  the  day 
some  of  which  manifested  themselves  as  blocky  letter  form  word- 
drawings,  some  of  which  I've  included  here. 


These  are  the  very  definition  of  "notes  to  self"  and  I  do  not 
recommend  trying  to  reconstruct  the  substance  of  anyone's 
presentation  from  these  drawings.  Some  are  actual  quotes,  other  are 
fragments  of  quotes,  others  are  observations.  Some  are  all  three 
combined.  These  should  be  treated  as  figure  drawings  where  the 
value  lies  more  in  the  exercise  of  doing  them  and  in  the  shadow  of 
their  suggestion  rather  than  any  actual  representation. 


Wherever  there  is  something  that  presents  itself  as 
inevitable  you  are  in  the  face  of  ideology. 


—  Zadie 

Smith  https : / /www . cbc . ca/radio/writersandcompany/the- 
brilliant-zadie-smith-on-what-keeps-her-urgently-engaged-with- 


the-world-around-her-1 .5360888 


As  to  the  subject  of  artificial  intelligence  and  machine  learning  in  the 
cultural  heritage  sector  I  am  not  a  disbeliever  but  I  not  yet  a  true 
believer  either.  To  the  extent  that  these  drawings  might  be  seen  as 
snarky,  or  even  hostile,  that  should  be  understood  more  as  more  a 
commentary  on  the  language  we  use  to  discuss  these  subjects  than  a 
reflection  on  the  nuance  and  subtlety  of  anyone's  argument. 


Also,  spelling  is  hard. 


It  was  encouraging  to  hear  both  Michael 

Keller  https://profiles.stanford.edu/michael-keller  and 

Aslak  Sira 

Myhre  https : / / en .wikipedia . org/wiki/Aslak_Sira_Myhre  , 
the  Librarian  of  Stanford  and  the  director  of  the  National  Library  of 
Norway  respectively,  agree  that  the  distinctions  between  libraries 
and  archives  and  museums  is  vanishing  as  everything  that  the  near¬ 
future  makes  possible  permeates  these  institutions.  This  idea  has 
been  something  of  hobby  horse  for 

me  https : / /www. aaronland . inf o/weblog/2017/ 02/20 /mostly/# 
mn -2017-004  so  it  was  nice  to  know  there  are  others  who  see  that 
future  with  sympathetic  eyes. 


As  the  day  progressed  and  as  the  question  of  what  it  means  to  be  a 
library,  and  in  particular  a  librarian,  in  the  face  of  all  these  new 
technologies  kept  resurfacing  I  found  myself  thinking  again  about 
"the  AK-47  story" .  This  was  part  of  the  preamble  to  a  talk  I 
delivered  https : / /www. aaronland. inf o /weblog/ 2 014/ 01/17/su 
nmuiiet/#ob  jects  at  the  Technology  experiments  in  art: 
Conserving  software-based 

art  https : / /www.eventbrite.com/e/technology-experiments- 
in-art-conserving-sof tware-based-art-new-date- ticket s- 
8587883591  symposium ,  in  J anuary  2014.  (The  irony  of  that  link 
being  an  Eventbrite  listings  page  with  nothing  of  substance  about  the 
symposium  is  not  lost  on  me.)  The  talk  then  had  nothing  to  do  with 


artificial  intelligence  but  the  broader  questions  about  the  relationship 
between  inference  and  meaning  that  the  AK-47  was  meant  to  raise 
still  seem  relevant  and  germane  to  the  issue  of  artificial  intelligences 
in  the  service  of  cultural  heritage  today.  I've  included  that  part  of  the 
talk  in-full  below: 


I  also  considered  adding  a  slide  with  Bill  Clinton's  famous  quote 

questioning  the  meaning  of  the  word 

"is"  http : / /www. slate.com/ articles/news_and_politics/chat 
terbox/ 1998 / 09/bill_clinton_and_the_meaning_of_is . html 


when  asked  whether  he  had  had  an  affair  with  Monica  Lewinsky  but 
the  common  thread  in  all  these  passages  is  the  idea  of  motive  and 
how  we  recognize 

it  https  : //pinboard .  in/u :  straup/t : motive  .  That's  an 
important  question  for  all  museums,  but  especially  for  a  design 
museum  since  by-and-large  we  all  have  the  same  things  in  our 
collections.  By  their  nature  "design  objects"  come  in  multiples,  often 
to  the  point  of  being  mass-produced  or  in  some  cases  not  even  being 
considered  design  objects  unless  they  are  mass-produced. 


For  example,  this  is  an  AK-47  from  the  collection  of  the 
Kalashnikov  Museum  http :  /  /www .  ak4 1  - 

guide.com/index.htmi  in  Izhevsk.  It  is  from  the  first  pilot  batch 
of  assault  rifles  produced  in  1948  that  would  go  on  to  be  adopted  for 
use  by  the  Soviet  Army  in  1949. 


This  is  a  Chinese-made  AK-47  from  the  collection  of  the  National 
Museum  of  American 

History  http: / / collections . si . edu/ search/ results . htm? 
q=record_iD :  nmah_4 392  60  .  Which  is  to  say:  The  Smithsonian  has 

a  Chinese-made  Russian  assault  rifle  in  its  collection.  Is  it  just  a 
talisman  of  the  Cold  War  period  or  might  we  imagine  that  it  was  a 
gift  from  Mao  Zedong  to  Richard  Nixon  during  his  famous  1972 
visit  to 

China  https : / / en .wikipedia . org/wiki/ 1972_Nixon_visit_to 
_china  ?  It  is  currently  not  on  display. 


This  is  an  AK-47  from  the  collection  of  the  CIA 

Museum  http:  / / investigations  .  nbcnews  .  com/_news/2 013/ 07/ 
24/19562  895-secret-cia-museum-features-osama-bin-ladens- 

ak-47?iite  .  It  was  "acquired"  sometime  in  2012.  It  is  said  to  have 
belonged  to  Osama  bin  Laden.  The  museum  remains  closed  to  the 
public  and  I  get  the  sense  that  it  was  never  really  meant  to  be  known 
to  anyone  outside  the  "family"  in  the  first  place. 


By  now  you've  probably  figured  out  that  these  are  all  the  same  image 
and  it's  not  any  of  the  actual  machine  guns  that  I've  been  describing. 
By  now  you've  probably  all  figured  out  that  this  is  the  same  picture 
of  the  same  AK-47  from 

Wikipedia  https://en.wikipedia.org/wiki/AK-4  7  , so  here  is 

a  picture  of  a  plush  AK- 

47  http: / /www. f lickr . com/ photos /2 324 3 094  @N0 0/2 2 39 9 002  7  6 
/  by  Mindy  Sue  Myers. 


I  might  also  have  also  told  you  that  any  one  of  those  AK-47s 
belonged  to  a  child  soldier  in  Sierra  Leone.  That  is  was  from  a 
museum  devoted  to  telling  the  history  of  child  soldiers  and  the 
mineral  wars  that  have  plagued  Africa  for  the  last  fifty  year.  Not  a 
word  of  that  story  would  have  true  been,  by  the  way.  So  why  does 
this  matter? 

It's  difficult  to  look  at  the  CIA  Museum's  AK-47  and  not  also  see 
Napoleon's  Vendome 

Column  https  :  / /en. wikipedia.org/wiki/Place_Vend%C3%B4me 
#The_vend .  C3 .  B4me_coiumn  .  For  anyone  not  familiar  with  the 
Vendome  Column  it's  a  big-ass  sculpture  in  the  center  of  Paris  in  a 
square  originally  built  the  celebrate  the  conquests  of  the  French 
Empire.  It  is  said  to  have  made  from  the  melted  canons  belonging  to 
all  the  armies  that  Napoleon  defeated  at  the  Battle  of  Austerlitz. 
Napoleon  was  not  lent  to  subtlety  and  the  Vendome  Column  is 
essentially  the  19th  century  version  of  the  fictional  Conan  the 
Barbarian's  answer  to  the  question  "What  is  best  in  life?"  to  which  he 
replied  "To  crush  your  enemies.  To  see  them  driven  before  you.  To 
hear  the  lamentation  of  their 

women,  https: //WWW. youtube. com/watch?v=6PQ6335pu0c  " 

If  you  think  I  am  just  being  provocative  stop  for  a  moment  and 
imagine  what  the  reaction  in  the  United  States  would  have  been  if 
the  Kalashnikov  Museum  had  acquired  Osama  bin  Laden's  AK-47. 


This  on  the  other  hand  is  a  proper  work  of  art  by  Peter  Kennard 
and  Cat 

Phillipps  http: / /www. theguardian.com/artanddesign/2013/oct 
/ 15/tony-blair-self ie-photo-op-imperial-war-museum  .  It  was 
on  display  at  the  Imperial  War  Museum  in  Manchester,  in  2013,  as 
part  of  an  exhibition  about  contemportary  art  and  war. 


The  late  painter  Francis  Bacon  gave  an  interview,  somewhere  around 
the  mid-point  of  his  career,  in  which  he  said  that  he  aspired  to  create 
paintings  that  defied  narrative.  Whether  or  not  he  succeeded  or 


whether  or  not  he  even  still  believed  that  idea  by  the  time  of  his 
death  is  sort  of  irrelevant.  We  have  always  celebrated  works  of 
exceptional  execution  and  in  contemporary  times  we  increasingly 
afford  artists  the  luxury  to  pursue  a  singular  itch  to  that  end. 

It  is  interesting  to  consider  that  as  the  art  world  and  the  discourse 
that  surrounds  it  continues  to  get  wordier  and  more  theory-driven  we 
are  also  seeing  both  museums  and  artists  create  works  that  can  only 
be  described  as  spectacles.  That's  a  whole  other  talk  but  just  keep 
this  idea  in  the  back  of  your  mind:  That  people  are  starting  to  use 
spectacle  itself  as  a  kind  of 

medium  http :  / /bldgblog .  blogspot .  com/ 2  013/ 08 /combat- 
preservation  .  html  in  part,  I  think,  because  it  remains  bigger  than 
words. 


I  want  to  mention  craft  and  the  timeless  arts-and-crafts  debate  only 
long  enough  to  describe  a  scenario  guaranteed  to  upset  everyone 
involved.  That  capital-A  art  is  the  Abel  to  capital-C  craft's  Cain,  but 
with  a  twist.  If  art  will  knowingly  murder  his  brother  the  problem  he 
faces  is  that  his  brother  is  also  a 

ZOtnbie  http : / / airshipdaily . com/ the-political-economy-of - 
zombies  who  can  never  die  and  wants  to  eat  his  brain. 


It's  not  a  very  flattering  picture  for  anyone  but  the  reason  I  enjoy  this 
fiction  is  because  it's  a  useful  way  to  consider  design.  That  is,  design 


is  the  shadow  of  the  unresolvable  struggle  between  an  outstanding, 
over-achieving  sociopath  and  a  his  seen-to-be  lesser  sibling  who 
refuses  to  give  up  no  matter  what  anyone  says. 


This  is  the  world's  first  operational  3D  printed  hand  gun.  It  was 
acquired  by  the  Victoria  and  Albert  Museum  last  year.  It  is  worth 
mentioning  that  in  writing  about  the 

acquisition  http :  / /WWW.  dezeen. com/ 2 013/0 9/2 6 /movie-kieran- 
long-v-and-a-museum-london-3d-printed-gun/  Dezeen  (.Com) 
made  a  point  of  noting  that  "the  original  prototypes  did  not  arrive  at 
the  museum  in  time  for  London  Design  Festival,  so  the  museum 
printed  out  a  copy  in  London  based  on  (the)  blueprints ." 


Right? 


Because,  you  know...  it's  a  3D  printed  object.  The  whole  point  of  3D 
printing  is  to  make  anything  Walter  Benjamin  ever  said  seem  quaint 
by  comparison.  That  does  not  make  it  any  less  difficult  to  resist  the 
allure  of  a  thing  imbued  with  aura,  whether  it's  real  or  imagined.  Is 
the  very  first  3D  printed  hand  gun  any  more  or  less  special  than  the 
very  first  AK-47? 


2019-12-05 


things  I  have  written  about 
elsewhere  #201 91 205 

go-iiif  version  2.1 


go-iiif  version  2.1 


negative:  San  Francisco  Airport,  meteorological  equipment,  c.  1931,  Collection  ofSFO  Museum,  2011.032.0124 


This  was  originally  published  on  the  SFO  Museum  Mills  Field 

weblog  https : //mil Is field. sf omuseum. org/blog/2 0 19/ 12 /05/ iiif-v2 1  ,  in 

December  2019. 


Today,  I  am  happy  to  announce  that  go-iiif  https :  //github.com/go-iiif/go- 
iiif  version  2.1.0  has  been  released  (although  version  2.1.0  has  already  been 
superseded  by  version  2 . 1 . 1  to  address  a  bug  https : //github.com/go- 
iiif / go-iiif /commit/924a2  9478c77 1 1718324d5 17c0 15682ad2 3 lb 7 9b  ).  A  quick 
refresher: 

II  IF  is  an  acronym  for  the  International  Image  Interoperability 
Framework  http  ://iiif.io/  ,a  project  driven  by  public  institutions  and 
private  companies  in  the  cultural  heritage  sector  to  produce  common  standards  and 
interfaces  (APIs)  for  accessing  and  working  with  collections  material. 


go-iiif  https://github.com/go-iiif/go-iiif  is  software  written  in  the  Go 
programming  language  https://goiang.org  that  implements  the  IIIF  Image 
API  http :  / / iiif .  io/api/image/  and  SFO  Museum  has  been  using  go-iiif 
to  process  the  images  in  its  collection.  We've  written  about  IIIF  before  in  the 
following  blog  posts: 

•  Using  IIIF  at  SFO 

Museum  https : //mills field. sfomuseum. org/blog/2 0 18/07/ 18/i 
iif  / 


•  Using  IIIF  (with  AWS)  at  SFO 

Museum  https : //mills field. sfomuseum. org/blog/2 0 19/02 / 12/i 
iif-aws/ 


•  go-iiif  version 

2.0  https : //mil Is field. sfomuseum.org/blog/2019/ll/13/ iiif- 
v2/ 


Version  2.1  of  go-iiif  introduces  two  relatively  minor  but  important  features: 
Custom  URI  functions  and  support  for 


fsnotify  https://github.com/fsnotify/fsnotify  filesystem  notifications. 


Custom  URIs 


negative:  San  Francisco  International  Airport  (SFO),  aerial,  1961,  Collection  ofSFO  Museum,  2011 .032 .0688 


go-iiif  version  2.1  introduces  the  notion  of  a  URI  "function"  which  is  an 
optional  piece  of  user-defined  code  that  converts  a  string  in  to  a  go-iiif-uri 
URI  object.  The  default  URI  function  simply  parses  a  raw  string  in  to  a  URI  based 
on  its  scheme  and  the  available  drivers  that  are  loaded.  Custom  URI  functions  allow 
you  to  perform  additional  steps  between  a  raw  input  string  and  a  final  URI. 


The  use  of  URI  strings  to  encode  image  paths  and  specific  processing  instructions  is 
incredibly  powerful.  On  the  other  they  hand  can  be  problematic  as  filenames:  Some 
operating  systems  disallow  the  use  of  (URI)  schemes  as  prefixes;  others  aren't  able 
to  determine  a  file's  content  type  if  its  name  contains  query  parameters;  no  matter 
what  they  are  long  and  a  bit  ugly. 


SFO  Museum  processes  its  images  in  what  is  essentially  a  bucket 
brigade  https : //en .Wikipedia .or g/wiki/Bucket_brigade  of  specialized 
tools  that  are  chained  together  using  signals  and  triggers .  While  there  is  nothing 
AWS  specific  about  this  workflow  we  use  the  S3  service  to  store  images  and  S3 
triggers  to  invoke  Lambda  functions  for  processing  those  images.  It  looks 
something  like  this: 


We  need  to  store  files  with  names  like  151124815 3_1 07  95.tif  that  will  be 
interpreted  as  f  ile :  /  / /151 1248153_10795  .  tif  but  ultimately  need  to  be 


converted  in  to  URIs  like  idsecret :  / / /151 1248 153_10795  .  tif  ? 
id=  1511248153  before  they  are  handed  off  to  the  code  that  finally  manipulates 
each  image. 


Here's  an  annotated  example  of  our  sf  om-iiif-process  tool  which  defines  a 
custom  URI  function  for  doing  just  that.  Error  handling  has  been  removed  for  the 
sake  of  brevity. 


We  begin  with  import  statements  for  loading  the  Go  packages  we  want  to  use  and  a 
main  (  )  function  that  is  the  entrypoint  for  our  tool: 


package  main 
import  ( 

"context " 

"errors" 

"  f  mt " 

iiif uri  " github . com/ go-iiif / go-iiif -uri " 

_  "github.com/ go-iiif /go-iiif /native" 
iiif tools  "github.com/go-iiif/go-iiif/tools" 

" github . com/whosonf irst /go-whosonf irst-mimetypes " 
"path/f ilepath" 

"strconv " 

"strings" 

) 

func  main( )  { 


Next,  we  define  a  function  for  parsing  a  raw  string  in  to  a  new  go-iiif- 

uri .  URI  instance.  Inside  this  function  the  first  thing  we  do  is  try  to  parse  the  raw 

string  in  to  any  kind  of  URI  instance  before  we  start  working  with  it. 


Assuming  it's  something  we  recognize  we  then  use  the  value  of  its  Origin  (  ) 
method  as  the  starting  point  for  creating  a  new  URI  instance: 

uri_func  :=  func(raw_uri  string)  (iiif uri. URI,  error)  { 

u,  _  :=  iiifuri .NewURI (raw_uri) 
origin  :=  u.Origin( ) 


We  perform  a  little  bit  of  extra  sanity -checking  to  ensure  this  file  "smells  or  at  least 
looks"  like  an  image: 


ext  :=  filepath. Ext (origin) 
ext_ok  :=  false 

for  _/  t  :=  range  mimetypes .TypesByExtension(ext )  { 

if  strings. HasPrefix(t,  "image/")  { 
ext_ok  =  true 
break 

} 

} 

if  !ext_ok  { 

return  nil,  errors .New( "Not  an  image") 

> 

Then  we  parse  the  filename  looking  for  a  specific  pattern,  one  that  allows  us  convert 
the  first  part  of  that  pattern  in  to  a  64-bit  integer  ID: 

parts  :=  strings . Split (origin,  ) 

if  len( parts)  !=  2  { 

return  nil,  errors .New( "Invalid  URI  string") 

} 

str_id  :=  parts[0] 

id,  _  :=  strconv.ParseInt(str_id,  10,  64) 

Remember,  this  is  what  works  for  us  and  doesn't  need  to  be  how  you  do  things.  The 
point  of  the  URI  function  is  to  allow  for  bespoke  customization  as  the  circumstances 
require. 


Finally  we  use  the  (64-bit  integer)  ID  and  the  origin  filename  to  create  a  new 
IdSecretURI  and  use  it  as  the  response  value  to  our  custom  URI  function: 


str_uri  :=  fmt . Sprintf ( " %s?id=%d" ,  origin,  id) 
str_uri  =  iiifuri .NewIdSecretURIString( str_uri ) 

return  iiifuri . NewIdSecretURI ( str_uri ) 

} 

Inside  the  main  loop  we  pass  our  custom  function  to  the  new 
NewProcessToolWithURIFunc  function  which  will  return  a  (processing)  tool 
instance  that  we  run  as  usual: 


tool,  _  :=  iiif tools. NewProcessToolWithURIFunc (uri_func) 
tool . Run ( context . Background ( ) ) 


fsnotify,  Lambda  and  "sustainable"  triggers 


Tips  for  Time-Zone  Travelers 


A  service  from 

CONTINENTAL  AIRLINES  » 


flight  information  packet:  Continental  Airlines,  c.  1985,  Collection  of  SFO  Museum,  2011.126.462 


The  other  addition  in  go-iiif  version  2.1,  is  the  ability  to  run  both  the  process 
and  tileseed  tools  in  "fsnotify"  mode. 


fsnotify  https :  //github.com/fsnotify/fsnotify  is  the  name  of  a  Go  package 
that  provides  "cross-platform  file  system  notifications"  for  applications.  These 
notifications,  in  a  go-iiif  context  act  as  triggers  allowing  us  to  automatically 
invoke  image  processing  when  a  file  is  added  to  a  folder. 


Under  the  hood  when  the  code  receives  a  fsnotify .  Create  event  for  a  path  it 
passes  that  path  to  the  URI  function  defined  for  that  tool.  If  the  function  returns  a 
valid  go-iiif-uri  URI  then  it  is  processed.  Here's  an  abbreviated  version  of 
what's  happening: 


if  event. Op  ==  fsnotify .Create  { 

abs_path,  _  :=  filepath.Abs (event .Name) 

rel_path  :=  strings .Replace ( abs_path,  root,  1) 

rel_path  =  strings .TrimLeft ( rel_path,  "/") 

//  't'  here  is  the  go-iiif  Tool  instance  returned  by 
//  iiif tools. NewProcessToolWithURIFunc(uri_func)  or 

//  iiif tools .NewProcessTool ( )  < —  which  uses  iiif tools .DefaultURIFunc( ) 
u,  err  :=  t .URIFunc(rel_path) 
if  err  !=  nil  { 

log. Printf ( "Failed  to  parse  path  '%s'  (%s)',  %s\n",  rel_path,  abs_path,  err) 
continue 


} 


err  =  ProcessMany (ctx,  process_opts ,  u) 


if  err  !=  nil  { 

log.Printf( "Failed  to  process  '%s'  ( ' %s '  ) ,  %s",  rel_path,  u,  err) 
continue 

} 

} 

Using  our  sfom-iiif-process  tool  as  an  example  all  we  need  to  do  to  enable 
filesystem  notifications  is  pass  in  the  -mode  f  snot  if  y  flag  at  startup.  For 
example: 


$>  go  run  -mod  vendor  cmd/sfom-iiif-process-image/main.go  \ 

-conf ig-source  1  file: / //usr/local/sfomuseum/go-sfomuseum-iiif /docs/conf ig '  \ 
-instructions-source  ' file: ///usr/local/sfomuseum/go-sfomuseum-iiif /docs/conf ig '  \ 
-report  -report-source  ' f ile : ///usr/local/data/media/pending '  \ 

-mode  fsnotify 

2019/11/26  13:27:19  Watching  '/usr/local/data/media/pending' 


Now  imagine  that  we  use  the  Go  Cloud 

blob  https :  / / gocioud .  dev/howto/blob/  package  to  write  an  image  named 
151124  8157_10801  .  tif  in  to  the  /usr/local/data/media/pending 
folder. 


The  first  thing  we  see  is  a  temporary  file  (created  by  the  Go  Cloud  package),  so  we 
can  skip  it. 


2019/11/26  13:27:47  f ileblob353713886  f ile : ///f ileblob353713886 

2019/11/26  13:27:47  Failed  to  parse  path  ' f ileblob353713886 '  ( /usr/local/data/media/pending/f ileblob 

Next  is  a  file  called  1511248157_10801  .tif  .  attr.  These  .  attr  files  are 
created  by  the  Go  Cloud  package  and  are  not  images  so  we  can  safely  skip  them 
too: 


2019/11/26  13:27:48  1511248157_10801 . tif . attrs  file :/// 1511248 157_10801 .tif . attrs 

2019/11/26  13:27:48  Failed  to  parse  path  ' 1511248157_10801 .tif . attrs '  (/usr/local/data/media/pending 


Hey  look  an  image!  This  is  the  file  that  will  be  used  to  produce  the  derivative 
images  defined  in  our  (processing)  "instructions"  file: 


2019/11/26  13:27:48  1511248157  10801.tif  f ile : ///1511248157  10801.tif 


Followed  by  a  whole  lot  of  not-images: 


2019/11/26  13:27:50  1511248157 .geojson  file: ///1511248157 .geojson 

2019/11/26  13:27:50  Failed  to  parse  path  ' 1511248157 . geo json '  ( /usr/local/data/media/pending/1511248 
2019/11/26  13:27:50  1511248157 .geojson. attrs  file: ///1511248157 .geojson. attrs 

2019/11/26  13:27:50  Failed  to  parse  path  ' 1511248157 .geojson. attrs '  ( /usr /local/data/media/pending/ 1 
2019/11/26  13:27:50  process. json  file: ///process . json 

2019/11/26  13:27:50  Failed  to  parse  path  ' process . json 1  ( /usr/local/data/media/pending/process . json) 
2019/11/26  13:27:50  process . json. attrs  file: ///process . json. attrs 

2019/11/26  13:27:50  Failed  to  parse  path  'process. json. attrs '  ( /usr/local/data/media/pending/process 


The  changes  to  support  f  snotif  y  events  have  also  led  to  the  addition  of  a  new  - 
report-source  flag. 


This  flag  tells  the  processing  code  where  to  store  a  machine-readable  report 
detailing  which  files  were  created.  Those  files  used  to  be  stored  alongside  the 
derivative  images  but  sometimes  those  derivative  images  are  created  in  a  nested 
directory  tree  and  the  underlying  fsnotify  #  package  does  not  currently  support 
watching  directories  recursively. 


You  may  have  noticed,  in  the  diagram  above,  that  files  written  to  the  box  labeled 
"reports"  trigger  a  separate  process  called  the  sfom-iiif-process-report 
tool.  Nothing  about  the  fsnotify  package  is  go-iiif  specific  so  it  can  be  used 
with  any  files.  In  our  use  case  we  use  it  to  watch  for  newly  created  processing 
reports  and  then  use  those  files  to  update  the  metadata  associated  with  our  image 
records. 


The  processing  and  tile-seeding  tools  have  long  supported  a  -mode  lambda  flag 
which  allows  them  to  be  invoked  as  (AWS)  Lambda  functions.  This  allows  us  to 
process  lots  of  images  using  Amazon's  servers,  using  triggers  when  files  are  copied 
to  S3,  for  a  fraction  of  the  cost  that  it  would  take  to  do  the  same  work  on  dedicated 
servers. 


The  -fsnotify  flag  makes  it  possible  to  develop  and  test  simple  and  complex  S3- 
trigger-and-Lambda  based  workflows  locally  before  deploying  them  to  AWS .  This 
alone  makes  it  a  useful  feature  in  the  short-term. 


Longer-term,  and  importantly,  it  also  means  the  workflows  we  develop  aren't 
inextricably  bound  to  Amazon  services.  Knowing  that  we  don't  have  to  use  AWS 
and  knowing  that  there  is  an  alternative  avenue  for  accomplishing  the  same  work  in 
the  future,  should  we  ever  need  it,  goes  a  long  way  towards  making  it  easier  for  us 
to  want  to  use  AWS  in  the  present. 
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A  service  from 

CONTINENTAL  AIRLINES# 
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Who's  On  First  Browser  (v2) 


Who's  On  First  Browser  Lookup  a  Who's  On  First  ID  C4 


Montreal 


Montreal's  Who's  On  First  ID  is  101736545  and  its  relative  URI  is  101/736/545/1 01 736545.geojson 
It  is  a  locality  in  CA.  It  is  parented  by  Montreal. 

Its  bounding  box  is  45.41459067767231,  -73.9475518701442,  45.572744,  -73.47619754286481 
Its  principal  centroid  is  45 . 572744 ,  -73 . 586295. 

We  believe  this  record  to  be  current. 
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s  current  1  true 

s  ceased  -1  false 

s  deprecated  0  false 

s  superseded  0  false 

s  superseding  0  false 


This  was  originally  published  on  the  Who's  On  First 

weblog  https : //whosonfirst.org/blog/2019/12/20/browser/  ,  in  December 

2019 


go-whosonf  irst-browser  is  a  web  application  written  in  the  Go 
programming  language  https://goiang.org  for  rendering  known  Who's  On 
First  https://whosonfirst.org/  (WOF)  IDs  in  a  number  of  formats  including 
HTML,  SVG,  PNG  and  GeoJSON.  It  uses 

Bootstrap  https://getbootstrap.com/  for  HTML  layouts  and 
Leaflet  https://leafletjs.com/  , 

Tangram.js  https://github.com/tangrams/tangram  and 
Nextzen  https :  //nextzen.org  vector  tiles  for  rendering  maps.  All  of  these 
dependencies  are  bundled  with  the  tool  and  served  locally.  With  the  exception  of  the 
vector  tiles  (which  can  be  cached)  and  a  configurable  data  source  there  are  no 
external  dependencies.  It  is  designed  to  work  locally  and  remotely,  including  other 
people's  cloud  services,  with  a  variety  of  Who's  On  First  datasources. 

Some  things  this  tool  is  not : 

It  is  not  a  replacement  for  the  Who's  On  First 
Spelunker  https://spelunker.whosonfirst.org/  . 


At  least  not  yet. 


go-whosonf  irst-browser  was  designed  to  be  a  simple  display  tool  for 
known  Who's  On  First  (WOF)  IDs  and  records.  That  constitutes  a  third  to  half  of 
what  the  Spelunker  does  https://github.com/whosonfirst/whosonfirst-www- 
speiunker  (the  remainder  being  list  views  and  facets)  so  in  principle  it  would  be 
easy  enough  to  add  the  same  functionality  here.  Except  for  the  part  where  the 
Spelunker  is  backed  by  a  real  search  engine  (Elasticsearch). 


The  principle  advantage  of  migrating  Spelunker  functionality  to  this  package  is  that 
it  does  not  have  any  external  dependencies  and  has  support  for  multiple  data  sources 
and  caches  and  can  be  pre-compiled  in  to  a  standalone  binary  tool.  The  principle 
disadvantage  would  be  that  experimenting  and  developing  code  and  functionality  in 
Python  (used  by  the  existing  Spelunker)  has  a  lower  barrier  to  entry  than  doing  the 
same  in  Go  (used  by  this  package). 


For  the  time  being  they  are  separate  beasts. 

It  is  not  a  search  engine. 

This  is  a  tool  that  is  primarily  geared  towards  displaying  known  Who's  On  First  IDs. 
It  does  not  maintain  an  index,  or  a  list  of  known  records,  before  it  displays  them. 

It  would  be  easy  enough  to  add  flags  to  use  an  external  instance  of  the  Pelias 
Placeholder 

API  https : //mi 11s field. sfomuseum.org/blog/2019/ll/04/placeholder/ 
for  basic  search  functionality  so  we'll  add  that  to  the  list  of  features  for  a  "2.x" 
release. 


It  might  also  be  easy  enough  to  preload  a 

Bleve  https://github.com/bievesearch/bieve  index, or  generate  one  at 


runtime  depending  on  the  data  source  and  its  size,  but  that  is  currently  out  of  scope 
for  the  project. 

It  is  not  a  tool  for  editing  Who's  On  First  documents. 

At  least  not  yet. 


Interestingly  the  code  that  renders  Who's  On  First  (WOF)  property  dictionaries  in  to 
pretty  HTML  tables  is  the  same  code  used  for  the  experimental  Mapzen  "Yes  No 
Fix  https://whosonfirst.org/blog/2016/04/08/yesnofix/  "  project.  That 
functionality  has  not  been  enabled  or  tested  with  this  tool  yet. 


On  the  other  hand  editing  anything  besides  simple  key-value  pairs  means 
identifying  all  the  complex  types,  defining  rules  for  how  and  when  they  can  be 
updated  (or  added)  and  then  maintaining  all  the  code  to  do  that.  These  are  all 
worthwhile  efforts  but  they  are  equally  complex  and  not  things  this  tool  aims  to 
tackle  right  now. 


If  you'd  like  to  read  more  about  the  subject  of  editing  Who's  On  First  documents 
have  a  look  at: 

•  Dan  Phiffer's  blog  posts  about  the  Boundary  Issues  editing 

tool  https://whosonfirst.org/blog/tags/boundaryissues/  . 

•  Gary  Gale's  Three  Steps  Backwards,  One  Step  Forwards;  a  Tale  of 
Data  Consistency  and  JSON 

Schema  https : //whosonf irst . org/blog/2018/ 05/25 /three- 
steps  -backwards/ 


It  does  not  retrieve,  render  or  display  "alternate"  geometries 


It  really  should  but  today  it  does  not.  Hopefully  it  will,  soon. 


For  example 

The  default  data  source  for  the  browser  tool  is  to  fetch  records  from  the 
data . whosonf  irst .  org  servers  so  all  valid  WOF  records  are  available.  The 
default  caching  source  for  the  browser  tool  is  an  in-memory  data  structure  that  last 
only  as  long  as  the  application  is  running.  Other  more  persistent  caching  strategies, 
like  local  files  on  disk  or  to  a  remote  host,  are  discussed  below. 


To  start  the  Who's  On  First  browser  you  simply  type: 


$>  cd  go-whosonf irst-browser 

$>  go  build  -mod  vendor  -o  bin/whosonf irst-browser  cmd/whosonf irst-browser /main. go 
$>  bin/whosonf irst-browser  -enable-all  -nextzen-api-key  {NEXTZEN_APIKEY} 

2019/12/14  18:22:16  Listening  on  http: //localhost: 8080 


And  then  when  you  visited  http :  / /localhost :  8 080 /id/ 10 17 36545  in 
your  web  browser  you  would  see  this: 


Who's  On  First  Browser  Lookup  a  Who’s  On  First  ID 


Montreal 


Montreal's  Who's  On  First  ID  is  101736545  and  its  relative  URI  is  101/736/545/1 01 736545.geojson 


It  is  a  locality  in  CA.  It  is  parented  by  Montreal. 


Its  bounding  box  is  45.41459067767231,  -73.9475518701442,  45.572744,  -73.47619754286481 
Its  principal  centroid  is  45.572744,  -73.586295. 


We  believe  this  record  to  be  current. 


.  wof 

belongsto  102191575 
85633041 
136251273 
Montreal 


breaches 

concordances 


dbpedia  Montreal 
freebase  en.montreal 

factual  03c06bce- 
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cfd5bf3ef515 

geonames  6077243 
geoplanet  3534 

library  of  n80132975 
congress 

new  york  N59179828586486930801 

times 

qs_pg:id  239659 
tgnrid  7013051 

wikidata  Q340 
wikipedia  Montreal 


show  pretty 


"date: inception_lower" :  "1642-05-17" , 

"date : lnception_upper” :  “ 1642-05-17" , 

"edtf: cessation":  "uuuu", 

"edtf : inception" :  "1642-05-17“ , 

"geom:area":  0.042348, 

"geom:area_square_m" :  366812249.283765, 

"geom : bbox" :  "-73 . 9475518701, 45. 4145906777, -73 . 47 
61975429,45 . 7037982616" , 

“geom: latitude":  45.53206, 

"geom: longitude":  -73.647767, 

"gn: population":  1600000, 

"iso: country":  “CA", 

"Ibl: latitude":  45.572744, 

"Ibl: longitude":  -73.586295, 

"lbl:max_zoom":  13, 

"lbl:min_zoom":  6, 

"mps: latitude":  45.572744, 

"mps: longitude":  -73.586295, 

"mz:hierarchy_label":  1, 

"mz:is_current":  1, 

"mz:min_zoom":  4, 

"name:afr_x_preferred":  [ 

"Montreal" 

1, 

"nan»e:afr_x_variant":  [ 

"Montreal" 

1, 

"name:amh_x_preferred":  [ 


_x_preferred":  [ 


e:arg_x_preferred" :  [ 


"name:arz_x_preferred":  [ 


By  default  Who's  On  First  (WOF)  properties  are  rendered  as  nested  (and  collapsed) 
trees  but  there  is  are  handy  show  raw  and  show  pretty  toggles  for  viewing  the 
raw  WOF  GeoJSON  data. 


Output  formats 

The  following  output  formats  are  available. 


GeoJSON 

A  raw  Who's  On  First  (WOF)  GeoJSON  document.  For  example  if  you  visited 
http :  / /localhost :  8080 /geo  j son/1 01 73 6545  you  would  see  this: 


<-)  -» 

c  i it 

©  localhost:8080/geojson/1 01736545  •••  0  ☆  Q,  Search 
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Raw  Data  Headers 
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area: 
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afr_x_prefe 
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►  name 

afr.x.vana 

t:  [-] 
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red :  I~] 

ara_x_prefe 

red:  [_] 

red:  [.] 

HTML 

A  responsive  FITML  table  and  map  for  a  given  WOF  ID.  For  example  if  you  visited 
http :  /  /localhost  :8080/id/101736545  you  would  see  this: 


PNG 

A  PNG-encoded  representation  of  the  geometry  for  a  given  WOF  ID.  For  example 
if  you  visited  http :  /  /local host :  8  080 /png/ 101736545  you  would  see 
this: 


"select" 

A  JSON-encoded  slice  of  a  Who's  On  First  (WOF)  GeoJSON  document  matching  a 
query  pattern.  For  example  if  you  visited 
http : / /localhost : 8 080 /select/ 101736545? 
select=properties  .wof  :  concordances  you  would  see  this: 


oza 

H  localhost:8080;'select/101736545  X  Q 

© 

G1  (if  ©  localhost:8080/select/l  •••  (3  fa  Q_  Search 
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JSON  Raw  Data  Headers 

Save  Copy 

Collapse  All  Expand  All  7  Filter  JSON 

dbp:id: 
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fluid: 
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fct:id: 

"03c06bce-8f76-llel-848f-cfd5bf3ef515" 

gn:id: 
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lac: id: 
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nyt:id: 
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qs_pg:id 

239659 

TT 

7013051 

wk:page: 

"Montreal" 

As  of  this  writing  multiple  select  parameters  are  not  supported,  select 
parameters  that  do  not  match  the  regular  expression  defined  in  the  -select- 
pattern  flag  (at  startup)  will  trigger  an  error. 

SPR  (Standard  Places  Response) 

A  JSON-encoded  "standard  places  response"  for  a  given  WOF  ID.  For  example  if 
you  visited  http :  / /localhost :  8  080/ spr/ 101736545  you  would  see  this: 


|Q 
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0 
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: lastmodificd: 
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SVG 

An  XML-encoded  SVG  representation  of  the  geometry  for  a  given  WOF  ID.  For 
example  if  you  visited  http:  / /localhost :  8080/ svg/101736545  you 
would  see  this: 


Tiles 

go-whosonf  irst-browser  uses  Nextzen  https://nextzen.org/  vector 
data  tiles  and  the  Tangram.js  https  :  //github.com/tangrams/tangram 
rendering  library  for  displaying  maps.  The  Tangram  code  and  styling  assets  are 
bundled  with  this  tool  and  served  directly  but,  by  default,  tile  data  is  retrieved  from 
the  Nextzen  servers. 

It  is  possible  to  cache  those  tiles  locally  using  the  -proxy-tiles  flag  at  start  up. 
The  default  cache  for  proxying  tiles  is  an  ephemiral  in-memory  cache  but  you  can 
also  specify  an  alternative  go-cache  https : //github.com/whosonfirst/go- 
cache  cache .  Cache  source  using  the  -proxy-tiles -cache  flag.  Caches 
are  discussed  in  detail  below. 

You  will  need  a  valid  Nextzen  API  key  https://deveiopers.nextzen.org/  in 
order  for  map  tiles  to  work.  If  no  API  key  is  present  then  the  browser  tool  will 


display  the  SVG  rendering  for  a  place's  geometry.  For  example: 


<-  ->(?  O  ©  localhost:8080/id/101736545 


■  ©  ft  Q,  Search 


Who's  On  First  Browser 


Lookup  a  Who's  On  First  ID  j  ‘V 


Montreal 

Montreal's  Who's  On  First  ID  is  101736545  and  its  relative  URI  is  101/736/545/1 01 736545.geojson. 

or  (D  Console  D  Debugger  {}  Style  Editor  O  Performance  0  Memory  ti  Network  g  Storage  -fr  Accessibility  *  What's 

+  f  Filter  Styles  :hov  xls  +  0  EE  Layout 


Data  sources  and  Caches 

go-whosonf  irst-browser  uses  the  go- 

reader  https://github.com/whosonfirst/go-reader  reader  .  Reader  and 
gO-Cache  https://github.com/whosonfirst/go-cache  cache  .  Cache 
interfaces  for  reading  and  caching  data  respectively.  This  enables  the  "guts"  of  the 
code  to  be  developed  and  operate  independently  of  any  individual  data  source  or 
cache. 

Readers  and  caches  alike  are  instantiated  using  the  reader  .NewReader  or 
cache .  NewCache  methods  respectively.  In  both  case  the  methods  are  passed  a 
URI  string  indicating  the  type  of  instance  to  create.  For  example,  to  create  a  local 
filesystem  based  reader,  you  would  write: 


import  ( 


" github . com/whosonf irst /go-reader " 
) 


r,  _  :=  reader. NewReader ( "fs: ///usr/local/data" ) 
fh,  _  :=  r.Read( " 123/456/78/12345678 . geo json" ) 

The  base  go-reader  package  defines  a  small  number  of  built-in  "readers"  like  the 
one  for  reading  from  the  local  filesystem.  Others  types  of  readers  are  kept  in 
separate  packages  and  loaded  as-need.  Similar  to  the  way  the  Go  language 
database /sql  package  works  these  readers  announce  themselves  to  the  go- 
reader  package  when  they  are  initialized. 


For  example,  if  you  wanted  to  use  a  Go 

Cloud  https :  //gocioud. dev/howto/blob/  Blob  reader,  to  fetch  data  from  a 
cloud  provider's  storage  system,  you  would  do  something  like  this: 


import  ( 

" github . com/whosonf irst/go-reader " 

_  " github . com/whosonf irst/go-reader-blob" 

) 

r,  _  :=  reader .NewReader ( "s3 : //{S3_BUCKET}?region={S3_REGION} " ) 
fh,  _  :=  r.Read( "123/456/78/12345678. geojson" ) 


The  same  principles  appy  to  caches. 


The  default  whosonf  irst-browser  tool  allows  data  sources  to  be  specified  as  a 
local  filesystem  or  a  remote  HTTP(S)  endpoint  and  caching  sources  as  a  local 
filesystem  or  an  ephemiral  in- memory  lookup  table. 


This  is  what  the  code  for  default  whosonf  irst-browser  tool  looks  like,  with 
error  handling  omitted  for  the  sake  of  brevity: 


package  main 


import  ( 

"context" 

_  " github . com/whosonf irst /go-reader-http" 
"github.com/whosonfirst/go-whosonfirst-browser" 
) 


func  main( )  { 


ctx  :=  context .Background ( ) 
browser . Start ( ctx ) 

> 

The  default  settings  for  go-whosonf  irst-browser  are  to  fetch  data  from  the 
https  :  / / data,  whosonf  irst .  org  servers  and  to  cache  those  records  in  an 
ephemeral  in-memory  go-cache  https  :  //github.com/patrickmn/go-cache 
cache. 


If  you  wanted,  instead,  to  read  data  from  the  local  filesystem  you  would  start  the 
browser  like  this: 


$>  bin/whosonf irst-browser  -enable-all  \ 

-reader-source  ' f s : ///usr/local/data/whosonf irst-data-admin-us/data '  \ 
-nextzen-api-key  {NEXTZEN_APIKEY} 


Or  if  you  wanted  to  cache  WOF  records  to  the  local  filesystem  you  would  start  the 
browser  like  this: 


$>  bin/whosonf irst-browser  -enable-all  \ 

-cache-source  ' f s : ///usr/local/cache/whosonf irst '  \ 
-nextzen-api-key  {NEXTZEN_APIKEY} 


The  browser  tool  will  work  with  any  WOF-like  data  including  records  outside  of  the 
"core  https :  /  /  github .  com/ whos  on  first-data  "  dataset.  For  example  this  is 
how  you  might  use  the  browser  tool  with  the  SFO  Museum  architecture 
dataset  https : //mil Is field. sfomuseum. org/blog/2 018/08/2 8 /whosonf irst 
/  : 


$>  bin/whosonf irst-browser  -enable-all  \ 

-reader-source  ' f s : ///usr/local/data/sf omuseum-data-architecture/data '  \ 
-nextzen-api-key  {NEXTZEN_APIKEY} 


And  then  if  you  went  to  http:  /  /localhost  :8080/id/1159554801  in 
your  browser  you  would  see: 


This  record  has  been  superseded  by  the  following  records:  SFO  Terminal  Complex  ( 1988 -  -  2000-)  .  This  record  supersedes  the  following  records:  SFO 

Terminal  Complex  (1981-  -  1983-)  . 

SFO  Terminal  Complex's  Who’s  On  First  ID  is  1 1 59554801  and  its  relative  URI  is  1 1 5/955/480/1/1 1 59554801  .geojson. 

It  is  a  building  in  US.  It  is  parented  by  Who's  On  First  ID  102527513. 

Its  bounding  box  is  37. 61226082114054,  -122.39033463643914,  37.616959,  -122.38087823616486 
Its  principal  centroid  is  37 .616959 ,  -122 . 385724. 

We  no  longer  believe  this  record  to  be  current. 


SFO  Terminal  Complex 


Who's  On  First  Browser 


Lookup  a  Who's  On  First  ID 


The  "guts"  of  the  application  live  in  the  browser .  go  package.  This  is  by  design 
to  make  it  easy  (or  easier,  at  least)  to  create  derivative  browser  tools  that  use  custom 
readers  or  caches. 


For  example  if  you  wanted  to  create  a  browser  that  read  files  using  the  Go  Cloud 
Blob  package  https :  //gocioud.dev/howto/blob/  you  would  write: 


//  cmd/blob-browser/main.go 
package  main 

import  ( 

"context " 

_  "github . com/whosonf irst/go-reader-blob" 
"github.com/whosonfirst/go-whosonfirst-browser" 

) 

func  main( )  { 

ctx  :=  context .Background ( ) 
browser . Start ( ctx ) 

> 


And  then  you  would  start  the  browser  tool  like  this: 


$>  bin/blob-browser  -enable-all  \ 

-reader-source  ' s3 : //{BUCKET} ?region={REGION} '  \ 
-nextzen-api-key  {NEXTZEN_APIKEY} 

2019/12/18  08:44:15  Listening  on  http: //localhost : 8080 


Or  if  you  wanted  to  read  data  from  a  specific  GitHub  repository: 


//  cmd/github-browser/main.go 
package  main 

import  ( 

"context " 

_  "github.com/whosonfirst/go-reader-github" 
"github.com/whosonfirst/go-whosonfirst-browser" 

) 

func  main( )  { 

ctx  :=  context. Background ( ) 
browser . Start ( ctx ) 

> 

And  then: 


$>  bin/github-browser  -enable-all  \ 

-reader-source  ' github: //whosonf irst-data/whosonf irst-data-admin-ca 1 
-nextzen-api-key  {NEXTZEN_APIKEY} 

2019/12/18  08:44:15  Listening  on  http: //localhost : 8080 


As  of  this  writing  the  browser .  go  packages  does  everything  including  parsing 
command  line  flags.  This  is  not  ideal  and  flag  parsing  will  be  moved  in  to  a  separate 
method  and  be  made  extensible. 


go-whosonfirst-browser-sqlite 

To  make  these  ideas  a  little  more  concrete  we've  created  a  separate  go-whosonfirst- 
browser-sqlite  https : //github . com/whosonf irst/go-whosonfirst-browser- 
sqiite  package  which  is  an  instance  of  the  Who's  On  First  browser  that  reads  all 
of  its  data  from  a  SQLite  https : //sqlite .or g/ index . html  database. 


This  browser  uses  the  still  experimental  go-reader-database- 
sql  https : //github . com/whosonf irst/go-reader-database-sql  reader 
package  which  is  designed  to  work  with  anything  that  implements  the  Go  languages 
database/sql  https://golang.org/pkg/database/sql/  DB  interface. 


The  instantiate  a  database-sql  reader  you  pass  it  a  URI  string  in  the  form  of: 


"  sql :  /  / "  +  {DATABASE_DRIVER}  +  "/"  +  { DATABASEJTABLE }  +  "/"  +  { DATABASE_KEY }  +  "/"  { DATABASE_VALUE } 


Or: 


sql :  //sqlite/geo  json/ id/body?dsn=/usr/ local /data/ fr  .db 


Which  is  interpreted  by  the  reader  as: 


"SELECT  body  FROM  geojson  WHERE  id  =  {WOFID}  "  WITH  sqlite  DATABASE  /usr/local/data/f  r .  db 

The  database-sql  reader  is  designed  to  be  agnostic  about  databases  and 
database  tables  but  to  complete  the  example  let's  try  using  it  with  a  SQLite  database 
produced  by  the  go-whosonfirst-sqlite-features- 

index  https : // github . com/whosonf irst/ go-whosonf irst-sqlite-features- 
index  package.  The  following  commands  will  produce  a  WOF  SQLite 
distribution  https://dist.whosonfirst.org/sqiite/  database  for 
administrative  data  in  France  using  the  whosonfirst-data-admin- 
fr  https : //github . com/whosonf irst-data/whosonf irst-data-admin-fr 
GitHub  repository  as  its  data  source: 


$>  cd  /usr/local/go-whosonf irst-sqlite-features-index 

$>  go  run  -mod  vendor  cmd/wof-sqlite-index-features/main.go  -all  \ 

-dsn  /usr/local/data/f r .db  \ 

-mode  'git://'  \ 

https : //github. com/whosonf irst-data/whosonf irst-data-admin-fr. git 
. . .time  passes 


This  creates  a  new  SQLite  database  in  / usr/local/data/ f r  .db  which  you 
can  then  use  as  a  database  for  your  SQLite-enabled  Who's  On  First  browser  like 
this: 


$>  cd  /usr/local/go-whosonf irst-browser-sqlite 

$>  go  run  cmd/whosonfirst-browser/main.go  -enable-all  \ 

-reader-source  1 sql : //sqlite3/geo j  son/id/body?dsn=/usr /local/data/f r . db '  \ 
-nextzen-api-key  {NEXTZEN_APIKEY} 


2019/12/19  13:12:26  Listening  on  http: //localhost : 8080 


And  then  when  you  visit  http :  / /localhost :  8080/ id/ 856833 85  you 
should  see  this: 


Who's  On  First  Browser 


Lookup  a  Who's  On  First  ID 


Seine-et-Marne 

Seine-et-Mame's  Who's  On  First  ID  is  85683385  and  its  relative  URI  is  856/833/85/85683385. geojson 
It  is  a  region  in  FR.  It  is  parented  by  lle-of-France. 

Its  bounding  box  is  48. 12053699999984,  2.39236749999981,  48.706827,  3.55845499999981 
Its  principal  centroid  is  48 .706827 ,  2 . 980815. 

We  believe  this  record  to  be  current. 


T  wof 

belongsto 


breaches 

concordances 


country 

geomhash 

hierarchy 


102191581 

France 

lle-of-France 


hasc:id 

unlc:id 

wikidata 


FR.IF.SE 

FR-77 

Q12753 


FR 

36b5daf20c942b467381f2be7cd56fd6 

continent  102191581 

country 

macro  region  lle-of-France 

region 

85683385 


*  edtf 

►  geom 

►  iso 

►  label 

►  Ibl 

►  mps 

►  mz 

r  name 


lang_x_official 

fra 

lang_x_spoken 

fra 

lastmodified 

2019-11-12T19:03:48.000Z 

name 

Seine-et-Marne 

parent Jd 

lle-of-France 

placetype 

region 

placetypejocal 

department 

population 

1347008 

population_rank 

12 

repo 

whosonfirst-data-admin-fr 

shortcode 

SE 

subdivision 

FR-77 

superseded.by 

supersedes 

tags 


afr_x_preferred 

Seine-et-Marne 

ara_x_preferred 

uJ-juj- 

arg_x_preferred 

Sena  y  Marne 

azb_x_preferred 

bel_x_preferred 

flanapiaMeHT  CeHa  i  MapHa 

bel_x_variant 

Cana  i  MapHa 

flanapTaMeHT  CeHa  i  MapHa 

ben_x_preferred 

m3h-45-j)Ich 

bre_x_preferred 

Seine-et-Marne 

bul_x_preferred 

CeH  e  MapH 

cat_x_preferred 

Sena  i  Marne 

ceb_x_preferred 

Seine-et-Marne 

ces_x_preferred 

Seine-et-Marne 

chv_x_preferred 

CeHa  TaTa  MapHa 

cym_x_preferred 

Seine-et-Marne 

dan_x_preferred 

Seine-et-Marne 

deu_x_preferred 

Departement  Seine-et-Marne 

el  l_x_pref  erred 

Zev-e-Mapv 

eng_x_preferred 

Seine-et-Marne 

epo_x_preferred 

Seine-et-Marne 

est_x_preferred 

Seine-et-Mame'i 

** — * - 

As  of  this  writing  the  Who's  On  First  browser  only  supports  a  single  "reader"  source 
and  "combined"  SQLite  distributions  for  WOF  data  (for  example  all  administrative 
in  a  single  database  rather  per-country  databases)  are  not  available.  If  you  want  to 
create  your  own  combined  databases  Stephen 

Epps  https://whosonfirst.org/blog/authors/steppsOO/  has  written  a 
handy  Bundling  "  combined  "  SQLite  distribution 

flies  https : //github . com/whosonf irst/whosonf irst- 

cookbook/blob/master/how_to/building_a_combined_distribution .md  guide. 


At  the  top  of  this  blog  post  I  mentioned  that  go-whosonfirst- 
browser  https : //github. com/whosonf irst/ go-whosonf irst-browser  is 
version  two  of  the  previously  named  go-whosonf  irst-static  package  that 
we  first  published  in  2018.  In  late  2017  when  it  became  clear  that  Mapzen  would 

shut  down  https : //whosonfirst.org/blog/2018/01/02/chapter-two/ 
everyone  began  to  think  about  how  and  where  the  various  projects  they  worked  on 
would  survive.  At  the  time  I  wrote: 


There  is  also  in-progress  work  to  build  an  on-demand  service  for 
publishing  static  renderings  of  Who’s  On  First  documents.  These 
include  HTML,  SVG  and  “standard  place  response”  (or  SPR)  JSON 
responses.  These  static  renderings  are  meant  to  serve  as  a  bridge 
between  the  raw  data  files  and  services  like  the  Spelunker  or  the  API 
and  live  under  the  places.whosonfirst.org  domain. 


The  places  .  whosonf  irst .  org  service  isn't  running  as  I  write  this  because  we 
stood  up  a  new  instance  of  the  Who's  On  First 

Spelunker  https :  //spelunker  .whosonfirst.org  and  partly  because  I  was  a 
little  traumatized  by  all  the  simple-but-not-really-simple  hoop-jumping  needed  to 


get  a  web  service,  with  no  external  dependencies,  running  using  AWS's  Lambda 
service. 


I  had  the  opportunity  to  revist  some  of  these  ideas  recently  which  are  documented  in 

the  Using  the  Placeholder  Geocoder  at  SFO  Museum 

https : //mi 11s field. sfomuseum.org/blog/2019/ll/04/placeholder/  blog 
post  and  I  decided  to  see  whether  that  lesson  could  be  applied  to  Who's  On  First.  In 
that  blog  post  I  wrote: 


There’s  a  longer  discussion  that  needs  to  be  had  sector-wide  about ... 
“vendor  lock-in”  and  the  inability  of  an  institution  to  wiggle  free  of 
vendor  lock-in  once  it  happens.  Our  goal  is  to  understand  the  ways  we 
need  develop  and  deploy  the  technical  scaffolding  to  service  our 
specific  efforts  without  letting  the  nuances  of  any  given  service 
provider  become  a  finger  trap. 


I've  started  joking  that  a  big  part  of  my  work,  these  days,  is  figuring  out  "how  to 
invite  cloud  providers  over  for  dinner  but  not  let  them  stay  the  night" .  You  can  see 
some  of  the  results  of  those  efforts  in  version  two  of  the  Who's  On  First  browser. 


We  aren't  running  the  browser  as  a  public-facing  tool  right  but  we  might  and  we 
could  but  more  importantly  you  can  too.  The  absence  of  search  or  any  kind  of  table 
of  contents  limits  the  tool's  immediate  usefulness  but  the  functionality  it  provides 
now  -  stable  representations  for  identifiers  in  a  number  of  formats  with  links  to  all 
the  other  identifiers  -  is  a  good  place  to  start. 


2019-12-20 


the  view  from  the  kitchen 


Timber  Cove,  December  2019 


Timber  Cove,  December 
2019 


Earlier  this  month  we  were  able  to  visit  Timber 

Cove  https://spelunker.whosonfirst.org/id/8592  6311/  ,  on 

the  coast  of  Northern  Sonoma,  for  a  few  days.  I  spent  a  lot  of  that 


time  making  drawings  of  the  view  from  the  kitchen.  These  are  some 
of  those  drawings. 


We  made 

galbijjim  https : / / cooking . nytimes . com/ recipes/ 10 199 18-han- 
oak-gaibi  j  jim  for  dinner  one  night.  The  spots  on  the  side  of  this 
drawing  are  the  stewing  sauce  that  escaped  (all  over  the  kitchen) 
from  a  blender  under  too  much  pressure. 


2019-12-29 


micro-dosing  the  kool-aid 


Wish  you  were  here 


Wish  you  were  here 


I  made  a  series  of  "San  Francisco"  postcards  this  year,  most  of  which 
were  mailed  to  people  as  they  were  produced.  They  are  as  nuanced 
as  any  postcard  is,  which  is  to  say  they  are  on  par  with  any  other  so- 
called  "hot  take"  you  might  find  in  another  medium.  I'm  not  sure  this 
is  the  story  I  want  to  remember  but  it  is  the  story  I  told  at  the  time. 


It's  been  an  interesting  experience  leaving  San  Francisco  in  2012  just 
as  the  most  recent  boom  times  were  starting  up  and  returning  in  2015 
as  they  were  in  full  swing.  Shortly  after  coming  back,  I  remember 
thinking  that  what  the  city  seemed  to  be  lacking  was  any  kind  of 
humility.  Then  I  remembered  that  San  Francisco  has  always  been  a 
boom-and-bust  town  and  has  never  been  humble  during  the  good 
times. 


Maybe  that's  true  of  all  cities  but  it  feels  especially  true  here.  I  think 
most  people,  locals  included,  associate  San  Francisco  with  the  city  as 
it  exists  in  between  the  flush  times  because  its  difficult  in  retrospect 
to  look  kindly  on  the  behaviour  that  "gold  rush"  days  give  rise  to. 


I'm  not  sure  that  any  of  these  observations  have  been  helpful,  or  even 
useful,  but  I  try  to  keep  them  in  mind  when  I  walk  out  in  to  it  every 
day. 


2019-12-31 


